Skip to content

Install and sign in

The same command installs the current CLI and updates an existing installation:

Terminal window
curl -fsS https://dash.backend.fast/install.sh | sh
bfast version

Supported machines are Linux x64, Mac Apple silicon and Mac Intel. The installer checks SHA256, checks that the binary runs, and replaces it atomically. It needs no sudo. It preserves your saved login.

It updates a writable regular bfast on your PATH. Otherwise, it uses $HOME/.local/bin. Follow its printed PATH instruction if needed.

Terminal window
curl -fsS https://dash.backend.fast/install.sh | sh -s -- --bin-dir "$HOME/.local/bin"
export PATH="$HOME/.local/bin:$PATH"

To update a local ./bfast, run this from its directory:

Terminal window
curl -fsS https://dash.backend.fast/install.sh | sh -s -- --bin-dir "$PWD"
./bfast version

You can inspect the installer first:

Terminal window
curl -fsS https://dash.backend.fast/install.sh -o install-bfast.sh
less install-bfast.sh
sh install-bfast.sh

The installer requires curl and sha256sum or shasum. Automatic update checks inside the CLI are not implemented. Run the installer again to update.

  1. Open the dashboard and sign in with your verified account.
  2. Open Agent credentials.
  3. Create a key with read, write and, when needed, delete permissions. Select an expiry.
  4. Run bfast login. Enter the key at its hidden prompt.
  5. Check the connection:
Terminal window
bfast whoami --json
bfast apps list --json

The dashboard shows a new key once. Give an agent the minimum scope it needs. Keep the key in a secret manager or the CLI’s private configuration file. Do not put it in source, URLs or command arguments.

For automation, pipe your secret manager’s output to bfast login --token-stdin. Use --config /absolute/private/path/cli.json to select another private profile. An agent still needs the owner to create its initial account/key.

Machine Binary
Linux x64 bfast-linux-amd64
Mac Apple silicon bfast-darwin-arm64
Mac Intel bfast-darwin-amd64
Checksums SHA256SUMS

Continue with the quickstart. If login fails, read troubleshooting.