Northflank

Deploy Genesis 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

1. Click Deploy Genesis to open the template.
2. Create an account on Northflank if you don't already have one.
3. Click Deploy Genesis now.
4. Set the required environment variable: GENESIS_GATEWAY_TOKEN (use a strong random value).
5. Click Deploy stack to build and run the Genesis template.
6. Wait for the deployment to complete, then click View resources.
7. Open the Genesis service.
8. Open the public Genesis URL at /genesis and connect using the configured shared secret. This template uses GENESIS_GATEWAY_TOKEN by default; if you replace it with password auth, use that password instead.

What you get

• Hosted Genesis Gateway + Control UI
• Persistent storage via Northflank Volume (/data) so genesis.json, per-agent auth-profiles.json, channel/provider state, sessions, and workspace survive redeploys

Connect a channel

Use the Control UI at /genesis or run genesis 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 Genesis up to date: Updating