Setup Wizard

Four steps to a running bot

getbot setup walks you through everything: connecting to your server, choosing an AI provider, naming your bot, and deploying — all in one command. Each step validates before moving on, so you won't get halfway through and discover a problem.

Step 1: Server connection

You'll be asked for your server's IP address, SSH key path, and user. If you don't have an SSH key, getbot auto-generates an ed25519 key at ~/.getbot/id_ed25519 and prints the ssh-copy-id command to copy it to your server. See SSH Connection for details.

getbot verifies the SSH connection immediately — before asking anything else. If it can't connect, you get an actionable error message with the exact fix (see SSH troubleshooting).

If you have a DigitalOcean token configured, getbot offers to auto-provision a droplet instead.

Step 2: AI provider

Pick your LLM provider — Claude (Anthropic), ChatGPT (OpenAI), or Gemini (Google). Enter your API key and getbot validates the prefix to catch common mistakes like pasting an Anthropic key when OpenAI is selected. If your provider is already configured, this step is skipped with a confirmation message.

Step 3: Bot details

Enter your work email address and an optional team name. getbot derives your organization from the email domain (e.g., alice@acme.com becomes the acme org). Team names default to auto-generated Docker-style names like "brave-falcon" — just press Enter.

Step 4: Confirm and deploy

You'll see a summary with your server IP, provider, masked API key, email, and team. Confirm to deploy. getbot then:

1. Runs pre-flight checks on your server (disk space, port conflicts, existing Incus)
2. Installs and initializes Incus for container isolation (if needed)
3. Installs the getbot-auth binary for Google SSO authentication
4. Creates an isolated container and deploys your bot

Each step shows a progress hint with approximate timing — "Installing Incus (~2 minutes)...", "Creating container (~30 seconds)...", "Deploying bot (~1 minute)...".

After deployment

  Setup complete!

  Your bot is live at: https://marketing.acme.example.com
  Sign in with Google using: alice@acme.com

  What's next:
    getbot bots list          — see your deployed bots
    getbot bots describe      — bot details and status
    getbot setup              — deploy another bot

Your bot's URL, sign-in instructions, and next commands are right there. No digging through docs to figure out what happened.