Ai Airlock

Activation

Activate Airlock after the stack is healthy and its URL opens in a browser. The setup flow creates the first administrator account, configures AI providers and defaults, and optionally connects a Telegram manager bot.

1. Create the administrator account

The installer prints the one-time activation code after its health check. If needed, retrieve it from the Airlock container:

docker compose exec airlock cat /var/lib/airlock/activation_code.txt

Open the Airlock URL, enter the activation code, email address, and display name. A passkey is selected by default; keep it selected to create a phishing-resistant sign-in credential, or clear it to set a password instead.

Airlock setup account page with activation code, administrator email, display name, and passkey option
Enter the one-time activation code and create the first administrator account.

2. Add an AI provider

Select a provider, enter its API key, and add it. The setup page shows the capabilities each provider supports, such as text, vision, speech, image generation, embeddings, or web search.

You can add more providers later in Airlock settings. Use Skip setup if you want to configure providers later.

Airlock provider setup page showing provider capabilities and API key configuration
Add a provider and API key for the capabilities your apps will use.

3. Choose default models

Choose default models for the capabilities that your apps need. Airlock uses these defaults when an app does not select a model itself. You can change them later under Settings.

Leave a capability unset when no configured provider supports it or when you do not need it yet.

Airlock default model setup page with build, text, vision, speech, image generation, embeddings, and web search model selectors
Set the defaults that new apps inherit, then continue.

4. Optionally connect Telegram

Airlock can use a Telegram manager bot to create and manage Telegram bots for your apps through Telegram’s managed-bots flow.

  1. Open @BotFather in Telegram and create a manager bot, or choose an existing bot.
  2. Select Open to launch BotFather’s web miniapp.
  3. Select the manager bot, or create a new one.
  4. Open Bot settings and enable the Bot Management Mode toggle.
  5. Copy the manager bot token into Airlock.
  6. Finish setup.

You can configure Telegram later if you do not need it during activation.

Airlock Telegram setup page describing the manager bot and its bot-management permission
A Telegram manager bot lets Airlock create and manage app bots.

Next step

Sign in with the passkey or password you created. Airlock is ready for creating and using apps.