Install Tyrn

Tyrn is a native app for macOS and Linux. This page covers getting the app, first launch, the command line tool and updates.

Requirements

macOS: a Mac with Apple silicon or Intel.
Linux: an x86_64 computer. ARM is not supported yet. You also need glibc 2.43 or newer (for example Ubuntu 26.04 or newer), an X11 or Wayland desktop, and a GPU with Vulkan support. See Linux.
Windows builds are planned.

Get and install

Tyrn is in private beta for macOS (Apple silicon and Intel) and Linux (x86_64). Request access at tyrn.dev with GitHub and we email you the download link, at the address on your GitHub account.

macOS

Download the DMG from the link in the email.
Open the DMG. Tyrn is notarized, and a license agreement appears when you open it. Read it and accept to continue.
Drag Tyrn to Applications.
Open Tyrn from Applications.

Linux

Download the tarball from the link in the email, for example Tyrn-0.9.1009-linux-x86_64.tar.gz. Download the install script from the same place.
Run the install script with the tarball:
Terminal window
```
sh install.sh Tyrn-0.9.1009-linux-x86_64.tar.gz
```
If the script tells you to add ~/.local/bin to your PATH, run the commands it prints, then open a new terminal.
Open Tyrn from your app menu or search, or run tyrn in a terminal.

The script needs no root access. It installs Tyrn into ~/.local/tyrn.app, links ~/.local/bin/tyrn and adds Tyrn to the app menu. See Linux for details.

First launch

Tyrn opens an empty window. Open a project with the + next to Projects in the sidebar, or follow the Quickstart.

The Tyrn backend ships inside the app and you never install it separately. It starts on its own the first time you create or open a session. It runs detached from the window, so it keeps running after you quit Tyrn. That is how sessions outlive the window. See How Tyrn works.

If the backend isn’t running, the sidebar shows “Daemon is not running.” with a Start daemon button. Click it to start the backend again. The sidebar’s daemon menu also has Start with debug logging, Restart daemon, Stop daemon, Show daemon log and Reload environment.

Install the command line tool

On Linux, the install script already links tyrn into ~/.local/bin. See Linux.

On macOS, choose Install CLI from the Tyrn app menu. It creates a tyrn link at /usr/local/bin/tyrn, and asks for administrator rights if it needs them. If it fails, see Can’t install CLI.

Tyrn works without an account. To sign in, open the account menu in the title bar and choose Sign In. It continues with GitHub in your browser.

Updates

Tyrn checks tyrn.dev for updates automatically every hour, and when you choose Check for Updates. It installs only updates signed by the Tyrn developer team. On Linux, updates install in place, so you don’t run the install script again. An update check sends only the version, platform and architecture.

To turn automatic updates off:

{
  "auto_update": false
}