Operations

Migrating Apps Between Servers

Move one app, or every project on a server, to a new machine.

Whether you're upgrading to a bigger box or consolidating servers, DeployOS can move apps between machines without you re-doing the setup by hand.

Moving a single app

From the Deployments page (or an app's own menu), choose Migrate and pick a target server. DeployOS:

  1. Rebuilds (or redeploys, if a cached image is usable) the app on the target server.
  2. Re-resolves which service and port actually got exposed on the new server, rather than trusting the values recorded on the old one — a build can genuinely expose something different the second time.
  3. Removes any stale route on the old server that still claims the app's domain(s), then publishes the new route on the target — so the domain follows the app instead of pointing at a dead server.
  4. Runs the same soft health check every deploy gets.

Once migration succeeds, the app's record simply points at the new server; the old server no longer runs it.

Moving everything on a server

Use Move all projects → another server from a server's quick-actions menu. This opens a migration panel that:

  • Shows every app's status in a sidebar as it moves, one at a time.
  • Shows a live log panel for whichever app is currently migrating.
  • Pauses on failure instead of silently plowing ahead — you get an explicit Continue to next button, so a broken migration is visible and readable rather than buried under nine more log streams.

Databases aren't migrated automatically

App migration moves the application containers and config — it does not move a database's data. To move a database along with an app, use Backups to dump it on the old server and restore it on the new one, or use the Databases page's own Migrate action, which dumps → transfers → restores in one step.