Install Farhelm
Farhelm runs as a desktop app on your Mac. The installer supports Macs with Apple silicon only; there is no installer for Linux yet. Linux machines and other Apple silicon Macs can still run your sessions, as hosts your Mac reaches over ssh; you add those from inside the app once it is running (Add a remote host).
Install
Section titled “Install”Run this shell command in a terminal:
curl -fsSL https://get.farhelm.io/install.sh | shIt needs no administrator password. It puts the Farhelm app in ~/Applications and the farhelm command in
~/.local/bin, and finishes by telling you Farhelm is installed and how to uninstall it later. After that, Farhelm
keeps itself up to date, installing new releases in the background; see
Update or uninstall Farhelm. Running the installer again also updates Farhelm, and
that is safe while Farhelm is open: Farhelm notices the new version, and its version number turns red until you restart
it. If an install was cut short, by a reboot or a power loss say, running the installer again finishes it and repairs
the copy it left behind. An installation older than v0.23.0 cannot be updated this way: the installer refuses and says
how to remove it first. Your data can stay, but the new version may not be able to use all of it.
Open Farhelm
Section titled “Open Farhelm”Open Farhelm from Spotlight or from ~/Applications. The app starts everything it needs by itself: there is no
background service to set up and nothing to run in a terminal. Your Mac is ready to run sessions as soon as the window
opens. The pieces has what runs where, for when you want the model behind it.
To remove Farhelm again, see Uninstall Farhelm.
Next: Your first session.