Installation Guide

Install Antigravity Manager on Linux, macOS, or Windows using terminal scripts, Homebrew, Docker, or manual download

Installation Guide

Antigravity Manager supports multiple installation methods across all major platforms. Choose the method that best fits your workflow.

Terminal Installation (Recommended)

The fastest way to install Antigravity Manager is using our cross-platform installation scripts. These scripts automatically detect your OS, architecture, and package manager.

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.27/install.sh | bash

irm https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.ps1 | iex

Supported Formats:

• Linux: .deb (Debian/Ubuntu), .rpm (Fedora/RHEL), .AppImage (Universal)
• macOS: .dmg (Universal Binary for Intel & Apple Silicon)
• Windows: NSIS .exe installer

Advanced Installation Options

The installation scripts support additional parameters for advanced users:

Linux/macOS

# Install a specific version
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.27/install.sh | VERSION=4.1.27 bash

# Preview mode (dry-run)
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.27/install.sh | bash -s -- --dry-run

# Show help
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.27/install.sh | bash -s -- --help

Windows

# Install a specific version
$Version = "4.1.27"; irm https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.ps1 | iex

# Preview mode (dry-run)
$DryRun = $true; irm https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.ps1 | iex

Homebrew Installation (macOS & Linux)

If you have Homebrew installed, you can use it to install and manage Antigravity Manager:

1. Add the Tap

   Subscribe to the Antigravity Manager repository:

   brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager
   
2. Install the Application

   Install Antigravity Tools as a cask:

   brew install --cask antigravity-tools
   
3. Fix Quarantine (macOS Only)

   If macOS shows “app is damaged”, add the --no-quarantine flag:

   brew install --cask --no-quarantine antigravity-tools
   

Arch Linux Specific Installation

Arch Linux users have two additional options:

One-Click Script (Recommended)

curl -sSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/deploy/arch/install.sh | bash

Homebrew (Linuxbrew)

If you have Linuxbrew installed:

brew tap lbjlaq/antigravity-manager https://github.com/lbjlaq/Antigravity-Manager
brew install --cask antigravity-tools

Docker Deployment (NAS/Server)

Docker deployment is recommended for headless servers, NAS devices, or containerized environments. The Docker image includes native v4.0.3 Headless architecture with built-in web UI.

Quick Start with Docker Run

docker run -d --name antigravity-manager \
  -p 8045:8045 \
  -e API_KEY=sk-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

API_KEY · string · required

Required. Used for all AI request authentication. Set this to any secure string (e.g., sk-antigravity).

WEB_PASSWORD · string

Optional. Used for Web UI login. If not set, defaults to API_KEY value.

ABV_MAX_BODY_SIZE · integer · default: "104857600"

Maximum request body size in bytes (default: 100MB). Increase for large multimodal requests.

Authentication Scenarios

Scenario A: Only API_KEY is set

• Web Login: Use API_KEY to access the dashboard
• API Calls: Use API_KEY for AI request authentication

This is the simplest setup for single-user environments.

Scenario B: Both API_KEY and WEB_PASSWORD are set (Recommended)

• Web Login: Must use WEB_PASSWORD. Using API Key will be rejected (more secure)
• API Calls: Continue to use API_KEY

This allows you to share the API Key with team members while keeping the admin password private.

Environment Variable Priority:

1. Environment variables (WEB_PASSWORD) - Highest priority, always used if set
2. Configuration file (gui_config.json → admin_password) - Used for persistent storage
3. Fallback - Uses API_KEY if neither is set

Docker Compose Deployment

For more complex setups, use Docker Compose:

1. Navigate to Docker Directory

   cd docker
   
2. Start the Service

   docker compose up -d
   
3. Access the Application

   • Admin Console: http://localhost:8045
   • API Base URL: http://localhost:8045/v1

System Requirements for Docker

Memory

Recommended: 1GB

Minimum: 256MB

Persistence

Mount /root/.antigravity_tools to preserve account data and configuration

Architecture

Supports both x86_64 and ARM64 platforms

Retrieving Forgotten Credentials

Docker Logs

docker logs antigravity-manager

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

Manual Download

Prefer to download the installer directly? Get the latest release from GitHub:

GitHub Releases

Download platform-specific installers:

• macOS: .dmg (Universal Binary - supports Apple Silicon & Intel)
• Windows: .msi or portable .zip
• Linux: .deb, .rpm, or AppImage

Platform-Specific Instructions

macOS

1. Download the DMG

   Get Antigravity.Tools_4.1.27_universal.dmg from GitHub Releases

2. Mount and Install

   Double-click the DMG and drag “Antigravity Tools” to Applications

3. Remove Quarantine

   If macOS shows “app is damaged”, run:

   sudo xattr -rd com.apple.quarantine "/Applications/Antigravity Tools.app"
   

Windows

1. Download the Installer

   Get Antigravity.Tools_4.1.27_x64-setup.exe from GitHub Releases

2. Run the Installer

   Double-click the installer and follow the setup wizard

3. Launch the Application

   Find “Antigravity Tools” in your Start Menu

Linux

.deb (Debian/Ubuntu)

sudo dpkg -i Antigravity.Tools_4.1.27_amd64.deb
sudo apt-get install -f  # Fix dependencies if needed

.rpm (Fedora/RHEL)

sudo dnf install Antigravity.Tools-4.1.27-1.x86_64.rpm
# Or for older systems:
sudo yum install Antigravity.Tools-4.1.27-1.x86_64.rpm

AppImage

# Make executable
chmod +x Antigravity.Tools_4.1.27_amd64.AppImage

# Move to binary path
mkdir -p ~/.local/bin
mv Antigravity.Tools_4.1.27_amd64.AppImage ~/.local/bin/antigravity-tools

# Add to PATH (if needed)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Troubleshooting

macOS: "App is damaged" error

This is caused by macOS Gatekeeper security for non-App Store applications.

Solution 1 - Command Line (Recommended):

sudo xattr -rd com.apple.quarantine "/Applications/Antigravity Tools.app"

Solution 2 - Homebrew Installation:

brew install --cask --no-quarantine antigravity-tools

Linux: AppImage won't run

Missing FUSE:

# Ubuntu/Debian
sudo apt install libfuse2

# Fedora
sudo dnf install fuse-libs

# Arch
sudo pacman -S fuse2

Permission Issues:

chmod +x Antigravity.Tools_4.1.27_amd64.AppImage

Docker: Connection refused

Check if container is running:

docker ps | grep antigravity-manager

View logs:

docker logs antigravity-manager

Verify port binding:

curl http://localhost:8045/health

Windows: Installation blocked by SmartScreen

1. Click “More info” in the SmartScreen dialog
2. Click “Run anyway”

This is normal for new installers that haven’t built reputation with Microsoft yet.

Verifying Installation

After installation, verify Antigravity Manager is working:

1. Launch the Application

   • Desktop: Find “Antigravity Tools” in your application launcher
   • Docker: Navigate to http://localhost:8045
2. Check Version

   The About page should show version 4.1.27

3. Test API Server

   Start the API proxy service and test:

   curl http://127.0.0.1:8045/health
   

Updating Antigravity Manager

Antigravity Manager v4.1.16+ includes native auto-update support:

Automatic Updates

The application will automatically check for updates and notify you when a new version is available. Updates download in the background.

Manual Updates

You can also manually download and install new versions from GitHub Releases.

Linux Auto-Update: v4.1.16+ includes full auto-update support for AppImage on both x86_64 and aarch64 architectures.

Next Steps

Quick Start Guide

Now that you have Antigravity Manager installed, learn how to add your first account and make API calls.