Skip to content

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:

ControlUse
Search boxFind a server by name, by ID, or by owner.
Status dropdownShow one status only.
Node dropdownShow 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:

ActionResult
View DashboardOpens the customer view of the server.
Edit ServerOpens the administrator page for the server.
MigrateOpens the migration page. See Moving a Server.
ReinstallWipes the files and runs the install script again. Asks first.
DeleteDeletes 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.

FieldUnitMinimum
Memory (RAM)MB128
Disk SpaceMB256
CPU LimitPercent on a Docker node, millicores on Kubernetes10 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:

FieldDefault
Backups2
Databases2
Allocations1

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

StatusMeaning
installingThe install script of the egg is running.
install_failedThe installation did not complete.
offlineThe server is installed and not running.
startingThe server is starting.
runningThe server is online and accepts connections.
stoppingThe server is shutting down.
suspendedAn administrator suspended the server.
restoring_backupA 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:

TabContent
AboutEvery identifier and limit, read-only.
DetailsServer name, owner, and description.
Build ConfigurationMemory, swap, disk, CPU, block IO weight, CPU pinning, bandwidth caps, host networking, and the database and backup limits.
StartupStartup command, Docker image, and every egg variable.
DatabaseCreate, rotate and delete databases for this server.
AllocationsAdd and remove ports, and set the primary allocation.
MountsHost folders mounted into the server.
TriggersConsole triggers. See Schedules and Triggers.
PlayersThe player list, where the game supports it.
FirewallFirewall rules for the server.
VersionsGame version management.
ManagePower controls, status override, suspend, reinstall, and delete.
ActivityThe 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.

  1. Open the server and go to the Manage tab.
  2. 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.

  1. Open the server and go to the Manage tab.
  2. Under Server Actions, click Reinstall Server.
  3. 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

  1. Open the server and go to the Manage tab.
  2. Under Server Actions, click Delete Server.
  3. 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:

  1. Select Target Node - each card shows the free allocations and the free memory.
  2. 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.
  3. 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:

ModeEffect
Cold TransferShort downtime while the pod restarts.
Live MigrationLeast 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

BadgerPanel Documentation