Skip to main content

​
Upgrade Guide

​
Docker Compose

​
Tauri Desktop

Download the latest release from GitHub Releases and install over the existing version.

​
Database Migrations

Database migrations run automatically on startup. No manual intervention required.

​
Graceful Shutdown During Upgrades

Myrm includes built-in Gateway Drain Control that protects in-flight Agent tasks during restarts:
  1. When the server receives a shutdown signal (SIGTERM or POST /system/shutdown), the AgentGateway enters draining mode.
  2. New Agent requests are rejected with a user-friendly message (“Service is restarting, please try again shortly.”).
  3. Currently running Agent turns are allowed up to 120 seconds to complete naturally.
  4. If tasks exceed the drain timeout, they are safely interrupted via the interrupt mechanism.
  5. After draining, all components (storage, MCP, browser, cron, etc.) shut down in parallel.
The frontend’s ConnectionManager automatically reconnects after the server restarts, ensuring a seamless experience. For Kubernetes deployments, set terminationGracePeriodSeconds to at least 150 seconds (120s drain + 30s buffer) in your pod spec to allow the drain to complete before forced termination.

​
Breaking Changes

​
Port Binding Security Hardening

All Docker Compose port mappings now bind to 127.0.0.1 (localhost only) by default. If you previously accessed Myrm from another device on your LAN (e.g. a phone or tablet), set MYRM_BIND_HOST=0.0.0.0 in your .env file to restore LAN access. Check the CHANGELOG for breaking changes before upgrading major versions.