Maintenance

Updating Agent Zero

Keep your Agent Zero installation up to date with the latest features and improvements.

Self Update (Recommended)

  1. Open Settings UI → Update tab
  2. Open Self Update
  3. Wait for the update checker to see if you have the latest version or if there's an available update.

You'll also be prompted through the UI when a new A0 version is released. Backups are automatically managed internally.

Agent Zero Self Update

Updating from Pre-v0.9.8

If you are upgrading from v0.9.8 or earlier, the architecture has changed significantly. You cannot use the in-app Self Update.

  1. Backup your data: Make a copy of your existing usr/ directory before starting.
  2. Run the new install script: Use the Quick Install script (curl -fsSL https://bash.agent-zero.ai | bash for macOS/Linux or irm https://ps.agent-zero.ai | iex for Windows).
  3. Migrate data: Copy the contents of your backed-up usr/ directory into the new a0/usr/ directory to restore your settings, memory, and plugins.

💡 Note: This migration ensures your old data perfectly slots into the new Docker-based architecture.

Manual Update (Advanced)

Use this method only if the self-update feature is unavailable or you need to manage containers manually.

  1. Keep current container running - Don't stop it yet!
  2. Pull latest image: docker pull agent0ai/agent-zero:latest
  3. Run NEW container on different port: docker run -d -p 50081:80 --name agent-zero-new agent0ai/agent-zero
  4. Backup from OLD instance: Settings → Backup & Restore → Create Backup
  5. Restore to NEW instance: Settings → Backup & Restore → Restore
  6. Verify and cleanup: Only delete old container after confirming data is restored

💡 Why This Process? Running both containers ensures you can always access your current data. If something goes wrong with the new version, your original Agent Zero is still running with all your data intact.

Additional Resources