Docker Deployment

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
Scenario B: Separate Passwords (Recommended)

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

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
API Endpoints
Health Check

Management Interface:

http://localhost:8045

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

curl http://localhost:8045/health

Response:

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

Managing the Container

# 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
Configuration File

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

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

Backup Data

cp -r ~/.antigravity_tools ~/.antigravity_tools.backup

Stop Old Container

docker stop antigravity-manager
docker rm antigravity-manager

Pull New Image

docker pull lbjlaq/antigravity-manager:latest

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

Verify container is running:
```
docker ps | grep antigravity
```
Check port mapping:
```
docker port antigravity-manager
```

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

Getting Started

Core Features

Integration Guides

Configuration

Deployment

Troubleshooting

Overview

System Requirements

Memory

Architecture

Quick Start

Pull and Run (Recommended)

Verify Installation

Environment Variables

Authentication Modes

Volume Mounts

Default Mount

Custom Mount Location

Port Mapping

Default: 8045:8045

Custom: 3000:8045

Accessing the Container

Managing the Container

Finding Your Credentials

Building Custom Image

Build Arguments

Advanced Configuration

Network Mode: Host

Custom Resource Limits

Upgrading from Old Versions

Troubleshooting

Next Steps

Docker Compose

Headless Mode

API Integration

Reverse Proxy

Build docs developers (and LLMs) love

Getting Started

Core Features

Integration Guides

Configuration

Deployment

Troubleshooting

​Overview

​System Requirements

Memory

Architecture

​Quick Start

​Pull and Run (Recommended)

​Verify Installation

​Environment Variables

​Authentication Modes

​Volume Mounts

​Default Mount

​Custom Mount Location

​Port Mapping

Default: 8045:8045

Custom: 3000:8045

​Accessing the Container

​Managing the Container

​Finding Your Credentials

​Building Custom Image

​Build Arguments

​Advanced Configuration

​Network Mode: Host

​Custom Resource Limits

​Upgrading from Old Versions

​Troubleshooting

​Next Steps

Docker Compose

Headless Mode

API Integration

Reverse Proxy

Build docs developers (and LLMs) love

Overview

System Requirements

Quick Start

Pull and Run (Recommended)

Verify Installation

Environment Variables

Authentication Modes

Volume Mounts

Default Mount

Custom Mount Location

Port Mapping

Accessing the Container

Managing the Container

Finding Your Credentials

Building Custom Image

Build Arguments

Advanced Configuration

Network Mode: Host

Custom Resource Limits

Upgrading from Old Versions

Troubleshooting

Next Steps