Docker Deployment

Deploy Antigravity Manager as a Docker container with Web UI and API support

Overview

Antigravity Manager provides a native headless Docker deployment with built-in Web UI hosting and API proxy capabilities. Perfect for NAS, servers, and containerized environments.

Docker deployment automatically runs in headless mode with Web-based management instead of a desktop GUI.

System Requirements

Memory

• Minimum: 256MB RAM
• Recommended: 1GB RAM

Architecture

• x86_64 (amd64)
• ARM64 (aarch64)

Quick Start

Pull and Run (Recommended)

Pull the pre-built image from Docker Hub:

docker run -d \
  --name antigravity-manager \
  -p 8045:8045 \
  -e API_KEY=your-api-key \
  -e WEB_PASSWORD=your-login-password \
  -e ABV_MAX_BODY_SIZE=104857600 \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

Security: Replace your-api-key and your-login-password with strong, unique values.

Verify Installation

Check container logs to confirm startup:

docker logs antigravity-manager

You should see:

🚀 Headless mode proxy service starting...
📍 Port: 8045
🔑 Current API Key: your-api-key
🔐 Web UI Password: your-login-password

Environment Variables

API_KEY · string · required

API key for AI requests. Used by Claude Code CLI, OpenAI-compatible clients, etc.

Alias: ABV_API_KEY

WEB_PASSWORD · string

Password for Web UI login. If not set, falls back to API_KEY.

Alias: ABV_WEB_PASSWORD

ABV_MAX_BODY_SIZE · integer · default: "104857600"

Maximum request body size in bytes. Default is 100MB for handling large images.

PORT · integer · default: "8045"

Internal container port (usually don’t change this).

LOG_LEVEL · string · default: "info"

Logging verbosity: debug, info, warn, or error.

ABV_BIND_LOCAL_ONLY · boolean · default: "false"

Bind to 127.0.0.1 only (localhost). Default is 0.0.0.0 (all interfaces) for Docker.

ABV_PUBLIC_URL · string

Public URL for OAuth callbacks when behind reverse proxy (e.g., https://antigravity.example.com).

ABV_DIST_PATH · string · default: "/app/dist"

Path to frontend static files (pre-configured in image).

AUTH_MODE · string · default: "AllExceptHealth"

Authentication mode: Off, Strict, AllExceptHealth, or Auto.

Alias: ABV_AUTH_MODE

Authentication Modes

Scenario A: API_KEY Only

docker run -d \
  --name antigravity-manager \
  -p 8045:8045 \
  -e API_KEY=sk-your-secret-key \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

Behavior:

• Web Login: Use API_KEY as password
• API Calls: Use API_KEY in Authorization header

Scenario B: Separate Passwords (Recommended)

docker run -d \
  --name antigravity-manager \
  -p 8045:8045 \
  -e API_KEY=sk-api-secret \
  -e WEB_PASSWORD=admin-password-123 \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

Behavior:

• Web Login: Use WEB_PASSWORD (API_KEY rejected for security)
• API Calls: Use API_KEY only
• Use Case: Share API key with team, keep admin password private

Volume Mounts

Data Persistence Required: Always mount /root/.antigravity_tools to preserve accounts and configuration.

Default Mount

-v ~/.antigravity_tools:/root/.antigravity_tools

Stores:

• Account tokens and OAuth credentials
• Application configuration (gui_config.json)
• Proxy logs and statistics
• Token usage database

Custom Mount Location

-v /path/to/your/data:/root/.antigravity_tools

Port Mapping

Default: 8045:8045

Standard port mapping for both Web UI and API

Custom: 3000:8045

Map host port 3000 to container port 8045

# Custom port example
docker run -d \
  --name antigravity-manager \
  -p 3000:8045 \
  -e API_KEY=sk-test \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

Access at: http://localhost:3000

Accessing the Container

Web UI

Management Interface:

http://localhost:8045

Login with WEB_PASSWORD (or API_KEY if password not set).

API Endpoints

OpenAI-Compatible:

http://localhost:8045/v1/chat/completions
http://localhost:8045/v1/images/generate

Anthropic-Compatible:

http://localhost:8045/v1/messages

Gemini-Compatible:

http://localhost:8045/v1beta/models

Health Check

curl http://localhost:8045/health

Response:

{"status":"ok","version":"4.1.27"}

Managing the Container

View Logs

# Real-time logs
docker logs -f antigravity-manager

# Last 100 lines
docker logs --tail 100 antigravity-manager

Finding Your Credentials

If you forgot your API key or password:

Docker Logs

docker logs antigravity-manager | grep -E "API Key|Password"

Configuration File

cat ~/.antigravity_tools/gui_config.json | grep -E '"api_key"|"admin_password"'

Building Custom Image

For development or customization:

# Clone repository
git clone https://github.com/lbjlaq/Antigravity-Manager.git
cd Antigravity-Manager

# Build with default settings
docker build -t antigravity-manager:custom -f docker/Dockerfile .

# Build with China mirror acceleration
docker build --build-arg USE_MIRROR=true -t antigravity-manager:custom -f docker/Dockerfile .

Build Arguments

USE_MIRROR · string · default: "auto"

• auto: Auto-detect network and use mirrors if Google is unreachable
• true: Force use China mirrors (Aliyun, npm mirror)
• false: Use official sources only

Advanced Configuration

Network Mode: Host

For direct localhost access (Linux only):

docker run -d \
  --name antigravity-manager \
  --network host \
  -e API_KEY=sk-test \
  -e ABV_BIND_LOCAL_ONLY=true \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

--network host doesn’t work on macOS/Windows Docker Desktop.

Custom Resource Limits

docker run -d \
  --name antigravity-manager \
  -p 8045:8045 \
  --memory=1g \
  --cpus=2 \
  -e API_KEY=sk-test \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

Upgrading from Old Versions

1. Backup Data

   cp -r ~/.antigravity_tools ~/.antigravity_tools.backup
   
2. Stop Old Container

   docker stop antigravity-manager
   docker rm antigravity-manager
   
3. Pull New Image

   docker pull lbjlaq/antigravity-manager:latest
   
4. Start with New Configuration

   Add WEB_PASSWORD if upgrading from v4.0.1 or earlier:

   docker run -d \
     --name antigravity-manager \
     -p 8045:8045 \
     -e API_KEY=sk-existing-key \
     -e WEB_PASSWORD=new-admin-password \
     -v ~/.antigravity_tools:/root/.antigravity_tools \
     lbjlaq/antigravity-manager:latest
   

Troubleshooting

Container exits immediately

Check logs for errors:

docker logs antigravity-manager

Common causes:

• Invalid environment variables
• Port 8045 already in use
• Permission issues with volume mount

Cannot access Web UI

1. Verify container is running:

   docker ps | grep antigravity
   

2. Check port mapping:

   docker port antigravity-manager
   

3. Test from inside container:

   docker exec antigravity-manager curl http://localhost:8045/health
   

API authentication fails

Verify credentials in logs:

docker logs antigravity-manager | head -20

Or check config:

docker exec antigravity-manager cat /root/.antigravity_tools/gui_config.json

High memory usage

Limit container memory:

docker update --memory=512m antigravity-manager

Next Steps

Docker Compose

Deploy with Docker Compose for easier management

Headless Mode

Learn about headless-specific features and configurations

API Integration

Connect Claude CLI, OpenCode, and other clients

Reverse Proxy

Set up Nginx or Caddy for HTTPS and custom domains