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 the single-VM Docker Compose deployment, let the control plane drain in-flight turns before recreating the container. Back up PostgreSQL and the cp-data volume, pin MYRM_VERSION, then run docker compose pull && docker compose up -d.

​
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.