Deploy from your terminal

01Install the CLI

The fugue CLI is a semantic wrapper over the Fugue control-plane API. Install it with a single command.

curl -fsSL https://raw.githubusercontent.com/yym68686/fugue/main/scripts/install_fugue_cli.sh | sh

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/yym68686/fugue/main/scripts/install_fugue_cli.ps1 | iex"

Confirm it is on your PATH:

fugue version

02Get your first API key

You authenticate the CLI with an API key minted from the console. For security the secret is shown only once, so copy it right away.

1. Sign in to the console.
2. Open the Access keys page from the sidebar.
3. Click New key, give it a name, pick the scopes it needs, and create it.
4. Copy the secret from the dialog — it will not be shown again.

03What the API key is for

The API key authenticates the CLI — and any direct API calls — to your tenant on the control plane. Every command you run, from deploy to logs to scaling, is authorized by the key you provide. Nothing runs against your workspace without one.

• Tenant API key — for everyday work: deploy apps, read logs, and manage services inside your workspace. Each key is limited to the scopes you grant it.
• Workspace admin key — your workspace's built-in high-privilege key. It is what mints and manages the other keys, so it is never shown for deletion.
• Platform / bootstrap key — reserved for cluster-wide admin commands. Keep it secret and use it only when an operation truly requires it.

04Authenticate and deploy

Save the key once, then deploy straight from a project directory. The CLI resolves your tenant, project, and app by name.

# save the key once (stored in your fugue config)
fugue auth login --token <your-api-key>

# …or export it for the current shell only
export FUGUE_API_KEY=<your-api-key>

# build and deploy the current directory
fugue deploy .

# list apps and stream logs
fugue app ls
fugue app logs <app-name>

05Connect your own server

Want Fugue to schedule workloads onto your own VPS? Open Servers, click Connect node, name the machine, and run the generated one-line command on it as root. The node joins the cluster in about a minute and then appears in your node list.

06Handy commands