Old School Ops

Moving a Server

Taking a running server to another machine without losing anything.

Every game · updated 2026-09-11

Three things move: the databases, settings.cfg, and anything you edited under gamedata. Everything else comes out of a release archive on the new machine.

The Order

  1. Stop the old server. A database copied while it is running is a database copied halfway through a write.
  2. Copy the data. db/ on the default backend, or a mysqldump on MySQL.
  3. Install the same version on the new machine, from the same release archive. A newer version may change the schema; move first, upgrade second.
  4. Restore the data and the settings.
  5. Start it, and sign in before pointing anybody at it.
  6. Update DNS or the launcher address last.

What Changes on the New Machine

SettingWhy
Any bind address naming the old machineIt does not exist there
Database host, if it moved too
Paths, if the directory layout differs

The database credentials and the game data do not change. Neither does the version.

Players Do Not Need to Do Anything

If the address is the same. If it is not, they need the new one in their launcher, so give them time before the old machine goes away.

Keeping the Old Machine

Leave it stopped rather than deleted for a week. It is the only rollback that does not depend on a backup being good, and a week is long enough for anything wrong to show up.

Something here wrong?

Out of date, incomplete, or assuming something it should not. Documentation errors are bugs, and this one arrives tagged and pointed at this page.

Loading…
Open the full search page