Deploy Apus on Northflank with a one-click template and access it through the web Control UI. This is the easiest "no terminal on the server" path: Northflank runs the Gateway for you.
How to get started
- Click Deploy Apus to open the template.
- Create an account on Northflank if you don't already have one.
- Click Deploy Apus now.
- Set these required environment variables:
APUS_GATEWAY_TOKEN(use a strong random value)APUS_STATE_DIR=/data/.apusAPUS_WORKSPACE_DIR=/data/workspace
- Click Deploy stack to build and run the Apus template.
- Wait for the deployment to complete, then click View resources.
- Open the Apus service.
- Open the public Apus URL at
/apusand connect using the configured shared secret. This template usesAPUS_GATEWAY_TOKENby default; if you replace it with password auth, use that password instead.
From the Northflank shell, run the read-only deployment preflight:
apus doctor --json
What you get
- Hosted Apus Gateway + Control UI
- Persistent storage via a Northflank Volume (
/data) soapus.json, shared and per-agent SQLite auth stores, channel/provider state, sessions, and workspace survive redeploys
Connect a channel
Use the Control UI at /apus, or run apus onboard via SSH for channel setup instructions:
- Telegram (fastest, just a bot token)
- Discord
- All channels
Next steps
- Set up messaging channels: Channels
- Configure the Gateway: Gateway configuration
- Keep Apus up to date: Updating