Installation

fx runs on macOS and Linux, on 64-bit Intel and ARM machines.

Install

$curl -fsSL https://fx.sh/setup.sh | bash

The installer puts fx in ~/.local/bin. Open a new terminal, then continue with Quick start.

Upgrade

When you open fx, it checks for updates in the background. Once an update downloads, the footer in the lower-right shows update ready: ctrl+g to reload. Press ctrl+g to restart fx with the new version.

To install an update now:

$fx upgrade

Use development releases

The dev channel follows changes merged into main after CI passes. Switch to it with:

$fx upgrade --channel dev

fx remembers the channel for later updates. Its startup header shows the release version, short commit SHA, and [dev], such as v0.0.9-e3ad6d8 [dev].

After an update, fx links changes to the commits since your previous dev release. Return to stable with:

$fx upgrade --channel stable

Other install options

Install a specific release:

$curl -fsSL https://fx.sh/setup.sh | bash -s -- <version>

To install somewhere else, pass FX_INSTALL_DIR to the installer. For example, to use ~/bin:

$curl -fsSL https://fx.sh/setup.sh | FX_INSTALL_DIR="$HOME/bin" bash

If your terminal cannot find fx, open a new terminal or add its install directory to PATH:

$export PATH="$HOME/.local/bin:$PATH"

Run fx --version to check the installed version. For installation problems, see Troubleshooting.