Skip to content

Your first server

Create your first game server, from an empty panel to players connecting.

Step 1: sign in

Open your panel domain in a browser, such as https://panel.example.com. Sign in with the administrator account you made during the installation.

Step 2: open the admin area

Click Admin Panel at the foot of the sidebar. Nodes, servers, games and users all live here.

Step 3: add a node

A node is a machine that runs game servers. It can be the panel server itself or a separate machine.

  1. Go to Admin > Nodes.
  2. Click Add Node.
  3. Fill in the form.
FieldDescription
Node NameA name for this node, such as us-east-1. Required.
DescriptionA note for your own use.
FQDN / IP AddressThe domain or IP of the node. Leave it blank to detect it.
Operating SystemLinux or Windows. Linux nodes need Docker, which the install command adds for you.
Memory Limit (MB)The memory the panel may hand out here. Leave it blank to detect it.
Disk Limit (MB)The disk the panel may hand out here. Leave it blank to detect it.
  1. Click Create Node.

The panel shows you an install command for this node. Copy it.

Step 4: install the daemon

The daemon is the agent that runs on a node and looks after its game servers. Your install command comes from your own panel and carries a registration token, so treat it as private.

Linux, as root:

bash
curl -sSL "https://panel.example.com/api/nodes/install/YOUR_TOKEN" | sudo bash

Windows, in PowerShell as Administrator:

powershell
irm 'https://panel.example.com/api/nodes/install/YOUR_TOKEN' | iex

On Windows the installer also opens port 8443 and port 2022 in the firewall.

WARNING

A registration token lasts 24 hours. If yours expires, open the node in the panel and make a new one.

Step 5: check the node is online

Go back to Admin > Nodes. The node reads Online once the daemon connects.

If it reads Pending Setup or Offline, work through these checks.

  • Make sure the daemon is running on the node.
    • Linux: systemctl status badger-daemon
    • Windows: Get-Service BadgerDaemon
  • Make sure the node can reach your panel over HTTPS on port 443.
  • Make sure no firewall blocks the node from reaching the panel.
  • Read the daemon log.
    • Linux: tail -n 50 /var/log/badger-daemon/daemon.log
    • Windows: Get-Content C:\BadgerDaemon\logs\daemon.log -Tail 50

Step 6: look at the games on offer

An egg is a template that tells the panel how to install and run one game. BadgerPanel ships with eggs for a long list of games.

  1. Go to Admin > Eggs to see them.
  2. Each egg carries the startup command, the install steps and the settings players can change.
  3. For a well-known game, use the egg that ships with the panel rather than writing your own.

Step 7: create the server

  1. Go to Admin > Servers.
  2. Click Create Server.
  3. Work through the seven steps of the wizard.
StepWhat you choose
1. OwnerThe user account that owns and runs this server.
2. NodeThe node the server runs on.
3. GameThe egg for the game you want.
4. ResourcesThe processor, memory and disk limits.
5. AllocationA free IP address and port on that node.
6. VariablesThe game settings the egg offers, such as the server name or version.
7. ReviewA summary of your choices.
  1. Click the create button on the review step.

The server starts installing. Open its Console tab to watch. A small game installs in under a minute, and a game with a large download takes longer.

Step 8: start it and connect

  1. Open Servers in the sidebar and pick your server.
  2. Click Start.
  3. Read the console to check that it starts cleanly.
  4. Connect from the game, using the address and port on the Network tab.

Next steps

BadgerPanel Documentation