Skip to main content
Get GeoEngine installed and ready to use on your machine. This guide walks you through installing Docker, the GeoEngine CLI, logging in, and optionally setting up AI agent skills and GIS plugin support.

​
Prerequisites

Before installing GeoEngine, make sure you have the following:

​
Required

  • Docker — GeoEngine runs all workers in Docker containers. Install Docker Desktop (macOS/Windows) or Docker Engine (Linux) and ensure it is running before using any GeoEngine commands.

​
Optional

  • GIS Platform(s) — Install one or both if you want to run workers directly from your GIS software:
  • AI Agent(s) — Install one or more if you want to use AI to create and manage workers automatically:

​
Step 1: Install GeoEngine

Choose the installation method that matches your platform:
Homebrew (recommended)
brew tap NikaGeospatial/geoengine
brew install geoengine
Shell script (alternative)
curl -fsSL https://raw.githubusercontent.com/NikaGeospatial/geoengine/main/install/install.sh | bash

​
Offline / Air-Gapped Installation

If your machine has no internet access, copy the geoengine binary to the target machine first, then run: 
./install.sh --local ./geoengine

​
Setup Troubleshooting

Xcode Command Line Tools ErrorGeoEngine itself does not depend on Xcode — it runs workers inside Docker containers. However, Homebrew (the macOS package manager used to install the GeoEngine CLI) requires the Xcode Command Line Tools to compile and link packages during installation. Without a compatible version of Xcode or its Command Line Tools, Homebrew cannot build the dependencies it needs, and the brew install geoengine step will fail.If you see errors related to Xcode or Xcode Command Line Tools when using Homebrew — such as:
Error: Your Xcode (14.0) is too outdated.

Error: Xcode alone is not sufficient on Catalina/Big Sur/Monterey/Ventura/Sonoma/Sequoia.

xcode-select: error: command line tools are already installed, use "Software Update" to install updates
You need to install or update Xcode before proceeding:
  1. Visit the Apple Developer Downloads page
  2. Sign in with your Apple ID
  3. Search for the latest version of Xcode compatible with your macOS version
  4. Download and install it
  5. After installation, open a terminal and run:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
  1. Then retry the Homebrew installation:
brew tap NikaGeospatial/geoengine
brew install geoengine
If you only need the Command Line Tools (without the full Xcode IDE), you can install them with xcode-select --install. However, some Homebrew formulae require the full Xcode application.

​
Step 2: Log In

GeoEngine requires a free Nika account. Run the login command before using any other GeoEngine command: 
geoengine auth login
This will open a browser window where you can authorise GeoEngine with your Nika account. If the browser does not open automatically, the terminal will display a URL — hold Cmd (macOS) or Ctrl (Windows/Linux) and click the URL to open it manually. GeoEngine OAuth login screen Click Authorize to complete the login. Your credentials are stored securely on your machine after the first login. You only need to run geoengine auth login again if your credentials expire or become corrupted. Running any GeoEngine command while logged out will print an error prompting you to log in.

​
Step 3: Initialise AI Agent Skills (Optional)

If you have an AI agent installed, run the following to install GeoEngine skills into your agent: 
geoengine patch --init
You will be prompted to select which agent(s) to install skills for:
  • Claude (Anthropic) — recommended
  • Cursor (Cursor AI)
  • GitHub Copilot (VS Code / Microsoft)
  • Codex (OpenAI)
  • Antigravity (Google)
Skills that are already up to date are skipped; changed or missing skills are installed automatically.

​
Verify Skills Are Working

After installing, open your AI agent and run the following prompt: 
What skills do you have?
If the agent lists the GeoEngine skills (use-geoengine, make-geoengine-worker, etc.), the installation was successful. If the agent does not mention GeoEngine skills in its response, try prompting more specifically: 
Do you have any GeoEngine-related skills installed?
If the agent still does not recognise the skills, check that the skill files are in the correct agent folder (e.g. ~/.claude/skills for Claude Code) and restart your agent. See Create & Modify a Worker Using AI Coder for the full workflow.

​
GIS Plugin Installation (If Using QGIS or ArcGIS Pro)

This step is only required if you plan to run GeoEngine workers from QGIS or ArcGIS Pro. If you only use the CLI or AI agents to run workers, you can skip this step entirely.
When you run geoengine apply for the first time on a worker that has a GIS plugin enabled in its geoengine.yaml, GeoEngine will prompt you to install the plugin automatically during the apply step. 
# In your geoengine.yaml:
plugins:
  arcgis: false
  qgis: true   # GeoEngine installs the QGIS plugin on first apply
If you upgrade GeoEngine later, run geoengine patch to bring all plugins back in sync: 
geoengine patch

​
Next Steps

You are now ready to start using GeoEngine! Follow the step-by-step guide to create your first worker!

​
Enabling GIS Plugin

This section will only apply after your first geoengine apply step. It is included for your information, but not part of GeoEngine’s core installation.
You can install QGIS from the QGIS website.Enabling QGIS Plugin
  1. The QGIS plugin is installed automatically when you first run geoengine apply [--dev] with qgis: true in your geoengine.yaml
  2. Open QGIS and in the top bar, click Plugins > Manage and Install Plugins…
  3. Navigate to the Installed tab and enable the GeoEngine plugin
  4. GeoEngine will now be available in the Processing menu
See Running Workers in ArcGIS Pro & QGIS for how to use the plugins once installed.