Skip to content
installcurl -fsSL https://get.farhelm.io/install.sh | sh

Settings

The gear at the foot of the navigation rail, the column of icons down the left edge of the sidebar, opens Settings at Sessions. Choose a section in its list to see its settings. Most take effect as soon as you change them. Fields you have not saved keep what you typed while you switch sections; closing Settings discards them, except that an edited recipe asks whether to save, discard or keep editing.

This page is a map: each section below says what it holds and links the page that explains it.

Color terminal frames by host colors each terminal’s frame to match its host’s icon. Name sessions on quick launch offers to name a session while its agent starts (Launch templates). Skip session confirmations makes stop, delete, replace, restart and closing a shell tab act on the first click (Stop, restart, and resume); it does not change the host questions below, the YOLO question, or the trash’s questions.

Choose System, Dark or Light. System follows your computer’s own setting. The terminal stays dark either way.

Update remote hosts automatically updates your remote hosts while Farhelm is open (Update a host). Set up new hosts without asking and Remove hosts without asking skip those two questions for SSH hosts when you add or remove one yourself. Turn them off to be asked again. Agents’ host requests still need your approval.

The shared catalog of recipes that Tensorlake sandboxes and container sessions start from, with each recipe’s Tensorlake snapshot and its build status on each container host.

Your Tensorlake account, the SSH key Farhelm uses for sandboxes, Create Tensorlake sandboxes without asking, and Sandboxes not on this helm. Deleting a sandbox always asks.

Whether each host is ready to run Podman containers, and container leftovers.

GitHub tokens, agent logins and API endpoint tokens that recipes can use (Save named credentials).

The terminal link choices, the file types that open with Cmd-click (Ctrl-click on Linux), and on a Mac, tunnels for remote localhost links.

Default checkout folder, Post-clone command and Keep a checkout ready for faster launches, for managed checkouts.

The switches that answer an agent’s directory-trust question for new managed checkouts, and the hints the session view shows when an agent asks (Trust in managed checkouts).

Sounds and ntfy alerts.

In the installed Farhelm app on your Mac, Install updates automatically is about updating Farhelm itself (Turn automatic updates off).

Approve what agents do covers the questions Farhelm asks before an agent acts.