Server management
Create a game server, change it, suspend it, move it or delete it.
A server runs on a Linux node, a Windows node or a Kubernetes cluster.
This page is the administrator side. For what a customer does day to day, see Server management.
Your servers
Navigate to Admin > Servers.
Three controls sit above the table:
| Control | Use |
|---|---|
| Search box | Find a server by name, by ID, or by owner. |
| Status dropdown | Show one status only. |
| Node dropdown | Show the servers on one node only. |
The table has these columns: Server, Status, Owner, Address, Node / Cluster, Resources, and Actions. Click an address to copy it. A blue dot in the Node column means Kubernetes. A green dot means a Docker node.
The list shows 30 servers per page and reads new data every 30 seconds.
Row actions
The three-dot button at the end of each row holds these actions:
| Action | Result |
|---|---|
| View Dashboard | Opens the customer view of the server. |
| Edit Server | Opens the administrator page for the server. |
| Migrate | Opens the migration page. See Moving a Server. |
| Reinstall | Wipes the files and runs the install script again. Asks first. |
| Delete | Deletes the server and its data. Asks first. |
Creating a server
Navigate to Admin > Servers > Create Server. The form has seven steps. Use Back and Next to move between them. When Next is blocked, the reason is printed next to the button.
1. owner
Search for the user who owns the server, then click their card.
2. node
First pick the deployment type: Docker Node or Kubernetes.
Then pick the node or the cluster. Each card shows the free memory and disk. A node in maintenance mode or offline cannot be selected. Node cards also carry a Windows or Linux badge.
3. game
Type a Server Name, and a description if you want one. Then search the list of games and select an egg.
The panel offers only the eggs that match the operating system of the node. Selecting an egg fills in the startup command and the Docker image.
4. resources
Three sliders set the limits. Each one has an Unlimited switch that stores a limit of 0.
| Field | Unit | Minimum |
|---|---|---|
| Memory (RAM) | MB | 128 |
| Disk Space | MB | 256 |
| CPU Limit | Percent on a Docker node, millicores on Kubernetes | 10 percent, or 100 millicores |
On a Docker node with storage pools, a Storage Pool dropdown chooses where the data folder lives. Leave it on the default for the local storage of the node.
Feature Limits sets three counts:
| Field | Default |
|---|---|
| Backups | 2 |
| Databases | 2 |
| Allocations | 1 |
5. allocation
On a Docker node, pick the address and port. Click a tile once to make it the primary allocation. Click the plus icon to add it as an additional allocation. Use Create Allocation to add a new port to the node without leaving the page. You can create a single port or a range.
On Kubernetes, choose the connection IP address, then choose Automatic for a random NodePort, or Custom Ports to name the exact ports.
6. variables
Fill in the startup variables of the egg. Each field shows the variable name, its key, and a description. Some eggs have none.
7. review
Read the summary. The switch Start server after installation is on by default. Click Create Server.
The page then shows the deployment progress: Initializing, Allocating Resources, Pulling Image & Creating Server, Running Install Script, and Starting. Click Continue in Background to leave the page. The install carries on.
What the statuses mean
| Status | Meaning |
|---|---|
installing | The install script of the egg is running. |
install_failed | The installation did not complete. |
offline | The server is installed and not running. |
starting | The server is starting. |
running | The server is online and accepts connections. |
stopping | The server is shutting down. |
suspended | An administrator suspended the server. |
restoring_backup | A backup restore is in progress. |
The panel pushes status changes to open pages as they happen.
If an install fails, the server page shows a banner with two buttons: Retry Installation and Mark as Offline.
Inside a server
Open a server from the list to reach the administrator page. It has these tabs:
| Tab | Content |
|---|---|
| About | Every identifier and limit, read-only. |
| Details | Server name, owner, and description. |
| Build Configuration | Memory, swap, disk, CPU, block IO weight, CPU pinning, bandwidth caps, host networking, and the database and backup limits. |
| Startup | Startup command, Docker image, and every egg variable. |
| Database | Create, rotate and delete databases for this server. |
| Allocations | Add and remove ports, and set the primary allocation. |
| Mounts | Host folders mounted into the server. |
| Triggers | Console triggers. See Schedules and Triggers. |
| Players | The player list, where the game supports it. |
| Firewall | Firewall rules for the server. |
| Versions | Game version management. |
| Manage | Power controls, status override, suspend, reinstall, and delete. |
| Activity | The action log for this server. |
A panel on the right always shows the owner, the node, and the current resource use. Open Console at the top right opens the customer console in a new tab.
The page reads new data every five seconds.
Changing the owner
Open the Details tab. Under Server Owner, search for the new owner and select them from the list. Then click Save Changes at the bottom of the form. The panel shows a pending note until you save.
Editing startup variables
On the Startup tab an administrator can edit every variable, including the ones that are read-only or hidden for the customer. Badges on each field show which is which.
Manual status override
The Manage tab has a Manual Status Override panel. Pick a status, then click Update Status.
WARNING
The override changes only the record in the panel. It does not touch the container or the process. Use it for a stuck install or a status that is clearly wrong, and not as a way to control the server.
Suspension
Suspension stops the server and blocks the owner from starting it.
- Open the server and go to the Manage tab.
- Under Server Actions, click Suspend Server.
The action takes effect at once. There is no confirmation and no reason field. The button then reads Unsuspend Server.
A suspended server shows a banner on the administrator page. In the customer view, every tab is replaced with a message that tells the owner to contact you.
Unsuspending gives access back at once. It does not start the server.
Reinstallation
A reinstall deletes the current files and runs the install script of the egg again. Use it for damaged game files.
- Open the server and go to the Manage tab.
- Under Server Actions, click Reinstall Server.
- Read the warning, then click Reinstall.
You can also reinstall from the three-dot menu on the server list.
DANGER
A reinstall wipes all server data and cannot be undone. Take a backup first.
The owner can also reinstall their own server from its Settings tab. They have to type the server name to confirm.
Deleting a server
- Open the server and go to the Manage tab.
- Under Server Actions, click Delete Server.
- Confirm twice. The second dialog is the last chance to stop.
Deletion removes the files, the databases, the backups, and the allocations. It cannot be undone. You return to the server list when it finishes.
You can also delete from the three-dot menu on the server list. That path asks once.
Moving a server
There are two different jobs here. Pick the right one.
A Docker server to another node
Use Migrate. Open the three-dot menu on the server list and select Migrate.
The page has three steps:
- Select Target Node - each card shows the free allocations and the free memory.
- Migration Options - three settings:
- Copy while the server runs keeps the server up during the file copy. The panel stops it only for the last part.
- Notify Users emails the owner.
- Verification Period (hours) sets how long you can roll the migration back. The default is 4 hours, and the range is 1 to 72.
- Preflight Check & Migrate - click Run Preflight Check. The panel lists any blocking issue and any warning. Click Start Migration when the check passes.
Side panels show the estimated duration, the expected downtime, and how each port maps from the old node to the new one. A port that changes is marked.
You can leave the page. The migration carries on, and the page shows the progress when you come back.
A Kubernetes server to another node in the cluster
Open the server, go to the Manage tab, and use the Transfer to Node panel. This panel appears for Kubernetes servers only.
Pick a target node, then pick a mode:
| Mode | Effect |
|---|---|
| Cold Transfer | Short downtime while the pod restarts. |
| Live Migration | Least downtime. Available only when the target node supports CRIU. |
Click Transfer Server, then confirm.
Acting on several at once
Feature
Bulk operations need the bulk operations feature in your license. Without it the checkboxes and the toolbar do not appear.
On the server list, tick the checkbox on each server that you want. A toolbar shows the count and these buttons:
- Start, Stop, Restart, Kill
- Suspend, Unsuspend
Each button asks for confirmation and names the number of servers. The panel sends the action to every selected server at the same time.
There is no bulk delete. Delete servers one at a time.
Next steps
- Server Management (user guide) - the console, backups, databases, and startup.
- Files and SFTP - the file manager and SFTP access.
- Server Network - ports, the country filter, and port access rules.
- Schedules and Triggers - timed tasks and console triggers.
- Server Users - subusers and their permissions.
- Eggs - game server templates.
- Allocations - add ports to a node.
