Skip to main content

​
Installation Guide

Antigravity Manager supports multiple installation methods across all major platforms. Choose the method that best fits your workflow. The fastest way to install Antigravity Manager is using our cross-platform installation scripts. These scripts automatically detect your OS, architecture, and package manager. 
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.27/install.sh | bash
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: 
# 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

​
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:

​
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

  • 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.
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: 1GBMinimum: 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 antigravity-manager

​
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

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"

​
Troubleshooting

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
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
Check if container is running:
docker ps | grep antigravity-manager
View logs:
docker logs antigravity-manager
Verify port binding:
curl http://localhost:8045/health
  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.

Build docs developers (and LLMs) love

Get started for freeTalk to us