5-Minute Self-Hosting
The AIST server runs as a single stateless binary backed by embedded SQLite (PocketBase) and bundles matching client binaries inside its ~42 MB container image. No external database, Redis, object storage, or required environment variables are needed.
1. Start the Server with Docker Compose
Create a compose.yaml file:
services:
server:
image: ghcr.io/llaoj/aist-server:latest
restart: unless-stopped
ports:
- "127.0.0.1:8090:8090"
volumes:
- ./data:/var/lib/aistBring it up:
docker compose up -d2. Create the Superuser Account
Create your administrator credentials directly via CLI (or use the one-time installer link printed in docker compose logs server on first boot):
docker compose exec server su-exec aist server superuser upsert [email protected] '<strong-password>'Open http://127.0.0.1:8090/_/ (or your reverse-proxied HTTPS URL) and sign in.
3. Set Application URL & Configure Upstream Models
- Set Application URL: Go to Settings → Application, set Application URL to your external server address (for example
https://aist.example.comorhttp://127.0.0.1:8090for local testing), and click Save. Both the landing page install snippet and/run.shautomatically inject this URL. - Add an Upstream Provider (
upstream_providerscollection):name: e.g.deepseekbase_url: OpenAI-compatible base URL without/chat/completions, e.g.https://api.deepseek.com/v1api_key: paste your upstream API key in plain text (masked as••••••••in API responses)enabled:true
- Add an Upstream Model (
upstream_modelscollection):provider: selectdeepseekname: upstream model ID, e.g.deepseek-chatdisplay_name: e.g.DeepSeek Chatpriority:10(smaller numbers are tried first)context_window:128000max_output_tokens:8192enabled:true
4. Create a User (or Invite Code) & Connect the Client
Either create a user directly in the users collection (assigning allowed_models), or create an invite code in invite_codes and register at /register.
Then install and connect the matching aist client directly from your server:
curl -fsSL http://127.0.0.1:8090/run.sh | shVerify server health anytime:
curl -fsS http://127.0.0.1:8090/v1/healthzIMPORTANT
Before exposing your server to the public internet, put it behind an HTTPS reverse proxy, restrict /_/ admin access, and configure SMTP if you enable self-registration or OTP login. See Docker Compose Deployment and HTTPS Reverse Proxy.