Edition: Server Control Plane

Centralized Control for AI Teams

Deploy the AiKey control plane on an intranet host to manage upstream providers, invite team seats, and issue virtual keys in bulk to your developers.

Installation Guide GitHub

Server Administrator

Deploys the control plane on an intranet host, onboards upstream providers like Claude and Codex, and issues virtual keys to seats.

Developer User

Installs the CLI on their workstation, logs in to the server, and uses the virtual keys issued against their email for local development.

Administrator Workflow

Deploy AiKey Server as a systemd-managed stack on your Linux infrastructure.

Step 01: Prerequisites

Architecture
Linux amd64/arm64
Verified OS
CentOS Stream 9 / Rocky 9 / Ubuntu 22.04
Stack
Docker + Compose v2
Auth
gh auth login

Step 02: Deploy Control Plane

gh auth login export GITHUB_TOKEN=$(gh auth token) gh release download v1.0.0-rc.3 -R aikeylabs/launch-master -p server-install.sh -D /tmp sh /tmp/server-install.sh --version v1.0.0-rc.3 --yes

Step 03: Control Panel Login

Access the UI at http://SERVER_IP:3000

Default Email admin@aikey.local
Default Pass Admin123456!

Developer Workflow

Onboard your workstation to the team control service.

1

Install Local CLI

curl -fsSL https://github.com/aikeylabs/launch/releases/download/v1.0.0-rc.3/local-install.sh | sh -s -- --version v1.0.0-rc.3 source ~/.zshrc
2

Log in to Server

aikey web aikey login --email developer@example.com --control-url http://SERVER_IP:3000
3

Use Virtual Keys

Click the install-hook banner in the web vault. Open a new terminal and run claude to verify routing.

Edition Comparison

Factual overview of deployment models based on source documentation.

Deployment Target

Infrastructure hosting environment

Personal Local

Local Workstation

Enterprise Server

Intranet Linux Host / Control Plane

User Roles

Access and permissions management

Personal Local

Single Developer

Enterprise Server

Server Administrator + Developer Users

Credential Source

Upstream provider authentication

Personal Local

Local Vault

Enterprise Server

Provider Accounts (Claude, Codex, etc.)

Access Distribution

Key provisioning and lifecycle

Personal Local

Local Route Tokens

Enterprise Server

Seats and Virtual Keys (aikey_vk_*)

Usage Visibility

Activity logging and telemetry

Personal Local

Local Usage Receipts

Enterprise Server

Centralized Reporting to Server

Operations

Service management and maintenance

Personal Local

Local CLI Tools

Enterprise Server

aikey-server status/logs/restart