> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nikaplanet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Maintain GeoEngine Files

> Handle GeoEngine versioning, updates, and patches, as well as common maintenance issues you may encounter.

## Updating GeoEngine

To update to the latest version, run:

```bash theme={null}
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.

...
```

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

## Patching GeoEngine

Sometimes, you might want to check on the integrity of GeoEngine artifacts. To do so, run:

```bash theme={null}
geoengine patch
```

GeoEngine checks the integrity of all artifacts and reports any issues it finds.

### Common Issues

| Issue                    | Solution                                                                       |
| ------------------------ | ------------------------------------------------------------------------------ |
| Stale config files found | Run `geoengine delete` and `geoengine apply` again to reset worker cache.      |
| Missing GIS plugins      | Run `geoengine setup plugins`, then restart QGIS or re-add the ArcGIS toolbox. |