Skip to main content

Updating GeoEngine

To update to the latest version, run:
geoengine update
GeoEngine detects how it was originally installed (Homebrew, curl, or PowerShell) and upgrades using the same method. After the binary is updated, it automatically runs geoengine patch to bring all workers, GIS plugins, and agent skills in sync with the new version. A typical update looks like this:
Detected install method: Homebrew
==> brew update
==> brew upgrade geoengine
==> Upgrading nikageospatial/geoengine/geoengine
  0.6.1 -> 0.6.4
==> Summary
🍺  /opt/homebrew/Cellar/geoengine/0.6.4: 4 files, 10.2MB, built in 1 second
GeoEngine updated via Homebrew

Running geoengine patch...
Checking global artifacts...
  ✓ settings.bin

Checking GIS plugins...
  ✓ QGIS plugin reinstalled (files were stale)
  • ArcGIS not installed on this machine — skipping

Checking agent skills...
  ✓ Claude skills up-to-date
  ✓ Codex skills up-to-date
  ✓ Antigravity skills up-to-date

Patch complete: 0 workers checked, 1 plugin updated, 0 skills synced,
               0 migrations applied, 0 issues found.

...
If the patch step reports that a GIS plugin was updated, restart QGIS or ArcGIS Pro to load the latest plugin version.

Patching GeoEngine

Sometimes, you might want to check on the integrity of GeoEngine artifacts. To do so, run:
geoengine patch
GeoEngine checks the integrity of all artifacts and reports any issues it finds.

Common Issues

IssueSolution
Stale config files foundRun geoengine delete and geoengine apply again to reset worker cache.
Missing GIS pluginsRun geoengine apply --dev on a worker with the GIS enabled.