Migrate Server
By the end of this page you will be able to move a server to another loader or Minecraft version, and know where anything that could not come along has been put.
Reaching it#
Press g on Home, or choose Migrate version from the CONFIG group of the Manage Servers actions menu, which opens this screen with that server already chosen.
The server has to be stopped. A running server is refused.
The steps#
| Step | What it asks |
|---|---|
| Choose Server | Which server is being migrated |
| Choose Server Engine | Pick the software your server runs on |
| Select Version | Which Minecraft version to move to |
| Review | Anything with no build for the target is moved to migration_backup |
The final step does the work and prints a log as it goes: it replaces the server jar, resolves every installed mod and plugin against the new loader and version, and moves whatever has no compatible build into migration_backup inside the server folder. The world, server.properties and every other file are left alone.
osmium migrate -s survival -l Paper -v 1.21.1 does the same from a shell, skipping the steps the flags already answer.
Keybindings#
| Key | Action | Notes |
|---|---|---|
↑, ↓, ←, → |
Navigate | |
enter |
Select | |
backspace |
Back | Answers are kept |
shift+tab |
Back | While a text field is open for typing |
esc |
Home | Nothing is touched |
While the migration runs:
| Key | Action | Notes |
|---|---|---|
↑, ↓ |
Scroll log |
Once it has finished:
| Key | Action | Notes |
|---|---|---|
enter |
Manage servers | |
esc |
Home |