Skip to main content

How do I update GoModel?

Back up your database first — Updating GoModel has the backup commands for each storage backend, plus verification and rollback. Then:
Then recreate the container. With Docker Compose:
Restart the gateway after updating; there is no in-place hot upgrade.

How do I check which version I’m running?

The version is also printed on the first line of the startup log.

Can I install a specific version, or roll back?

Yes — set GOMODEL_VERSION before running the installer:
On Windows set $env:GOMODEL_VERSION first. With Docker, use a version tag (enterpilot/gomodel:X.Y.Z) instead of latest. Replace X.Y.Z with a published GoModel release.

Is updating safe for my data?

Yes, updating is. The schema is migrated on startup, and an update never moves or deletes your database, configuration, or cache. Rolling back needs care. Most migrations are additive, and an older binary ignores what it does not know about — but some releases rebuild storage into a new shape, as scoped budgets and rate limits did, and the older binary will not find what it expects. Restore a backup taken before the update instead. GoModel ships fast, so take one every update: Updating GoModel has the commands.

Where does GoModel store its data?

When a ./data directory exists next to where you launch GoModel (existing deployments, the Docker image), the database stays at ./data/gomodel.db. Otherwise the binary uses your OS’s conventional per-user directories: The resolved database path is printed at startup (storage configured). SQLITE_PATH overrides the database path, and GOMODEL_CACHE_DIR overrides the model cache directory. Available from v0.1.54; older binaries always use ./data relative to the working directory.

How do I uninstall?

Remove the binary and, if you want a clean slate, the data directories:
On Windows, delete %LOCALAPPDATA%\Programs\gomodel (and %LOCALAPPDATA%\gomodel for data), then remove the folder from your user PATH. For Docker, remove the container and image as usual.

Why isn’t GoModel 100% open source?

Almost all of it is. The gateway is MIT-licensed and stays that way. A small commercial distribution — GoModel Pro, adding prompt compression, intelligent routing, OIDC SSO, and a few other extensions — is available; it accounts for roughly 3% of the codebase. The project has to pay for itself. Keeping a small part commercial asks the companies that profit from a well-built AI gateway to pay for it, and leaves it free for everyone else. That seems like the fairest trade available. Individual features are negotiable. If a Pro feature is one you need as a developer and paying for Pro doesn’t make sense for you, say so. A cheaper personal-use license — or open-sourcing that particular feature — is on the table. Ask on Discord or GitHub.
Last modified on November 7, 2026