Game servers
A game server runs Minecraft, Terraria or Valheim for your players, on your workspace's private network with a public address to share. Game servers are in the dashboard under Game servers.
Games
| Game | In the console | Players connect over | Join password |
|---|---|---|---|
| Minecraft: Java Edition 1.21.8 | Minecraft (Paper) | TCP | None |
| Terraria | Terraria (TShock) | TCP | None |
| Valheim | Valheim | UDP | Required |
Sizes
| Size | vCPU | Memory | Disk | Network | Games |
|---|---|---|---|---|---|
| Small | 1 | 1 GB | 8 GB | 50 Mbit/s | Terraria |
| Game 4 GB | 2 | 4 GB | 40 GB | 50 Mbit/s | Minecraft, Terraria, Valheim |
| Game 8 GB | 2 | 8 GB | 60 GB | 50 Mbit/s | Minecraft, Valheim |
| Game 16 GB | 4 | 16 GB | 80 GB | 100 Mbit/s | Minecraft, Valheim |
A game server takes its size from your account's quota, like any instance; the create form shows what it would use under Quota usage. The Free plan's quota, 2 vCPU and 2 GB of memory, fits a Terraria server on Small, but not the larger sizes.
Create a game server
Choose Game servers → New game server and pick a game:
- Server name, or World name for Terraria: 3 to 31 lowercase letters, digits and underscores, starting with a letter. It names the server in the console and its hostname.
- Password, under Configure credentials, for Minecraft and Valheim: 12 to 128 characters without spaces or quotation marks; leave it blank to have a strong one generated. For Valheim it is the password players type to join. For Minecraft it guards the server's remote console, and players never need it.
- Network access: Public, the default, so players can reach it, or Private.
- Plan: the size.
- For Minecraft, tick I accept the Minecraft EULA.
Choose Create instance. The Provisioning tab follows each step until the server is Ready. A new Valheim server generates its world on its first start, which can take several minutes.
Invite players
Give players the Public address from the Connection card on the server's Overview: its hostname and port, such as survival-7a1b.play.sahabti.app:40021. The port is the server's own public port on your workspace's shared IP, from 40000–49999, not the game's usual port, so players must include it:
- Minecraft: Multiplayer → Add Server, and enter the address with its port.
- Terraria: Multiplayer → Join via IP, then the hostname and the port.
- Valheim: Join Game → Add server, the address with its port, then the password.
To decide who may connect, edit the allowed sources of the game's built-in rule on the server's Network tab: see Instance network.
The game panel
The Game panel tab shows who is playing and gives you the server's console.
Players shows how many are online, checked every minute. A Minecraft server also lists their names; a Terraria server does not report players.
Server console sends a command to the running server and shows its reply. A command is up to 500 characters.
- Minecraft: the game's own server commands, such as
say Restarting in five minutes,whitelist add <player>orop <player>. - Terraria: the server's console commands.
- Valheim has no console of its own, so the panel offers these commands. Type
helpto list them:
| Command | Does |
|---|---|
status | Shows the server's settings |
players | Shows who is online |
admin add <SteamID64>, admin remove <SteamID64> | Adds or removes an admin |
ban add <SteamID64>, ban remove <SteamID64> | Bans a player, or lifts the ban |
permit add <SteamID64>, permit remove <SteamID64> | Manages the allow list: once it lists anyone, only those players can join |
list admin, list ban, list permit | Shows a list |
name <text> | Renames the server, then restarts it |
restart | Restarts the server, installing any game update first |
Files
While the server is running, its Files tab browses the game's own folder: the Minecraft or Terraria server's folder, with its worlds and settings, or Valheim's world data.
- Open a folder to look inside it, and Download or Delete a file.
- Upload puts a file in the folder you are in, under its own name. A file of the same name is replaced only once the whole upload has arrived, so an upload that is cut off leaves the old file as it was.
- Empty files cannot be uploaded.
Updates
A Valheim server installs any game update every time it starts or restarts. Minecraft and Terraria servers keep the version they were created with.
Start, stop and resize
- Restart restarts the server cleanly. Stop switches it off at once, so save first: a world change since the last save can be lost. Minecraft saves with
save-all, Terraria withsave, and Valheim saves every ten minutes on its own. - Resize plan, on the Settings tab, changes the vCPU and memory of a running server and grows its disk to the new size's. A Minecraft server's game uses the new memory from its next restart. The disk cannot shrink, so a size with a smaller disk can't be picked: a game server can only move to a larger size.
- Delete instance, under Danger zone on the Settings tab, destroys the server and its world; type
confirmto confirm.
Not offered yet
- Minecraft Bedrock Edition players and remote console tools need ports that your workspace's shared IP does not forward. Players join by address, as above.
- Valheim's List in the server browser switch, in the Game panel, works only on a dedicated IP, which is not offered yet.
- A plugin and mod manager: the Plugins card says it is on its way.
Who can do what
| Owner | Admin | Developer | Viewer | |
|---|---|---|---|---|
| See servers, players, the list of files and where they answer | ✓ | ✓ | ✓ | ✓ |
| See a server's password | ✓ | ✓ | ✓ | — |
| Create, start, stop, resize and delete servers | ✓ | ✓ | ✓ | — |
| Send console commands | ✓ | ✓ | ✓ | — |
| Download, upload and delete files | ✓ | ✓ | ✓ | — |
From the API and MCP
Create a server with POST /v1/servers or the MCP tool create_instance, with minecraft, terraria or valheim as engine and a size such as game-4 as plan. The console is POST /v1/servers/{id}/console and the player count GET /v1/servers/{id}/gauges, both in the API only.