Skip to Content
BytePanelBytePanel

Nodes

Install the BytePanel agent on a machine that runs game servers.

A node is a Linux machine that runs game servers in Docker. Each node runs the BytePanel agent, which the panel talks to over HTTPS.

Requirements

  • 64-bit Linux (x86_64) with systemd.
  • Docker.
  • unzip, for archive extraction in the file manager.
  • Open ports: the agent API (8080 by default), SFTP (2022 by default) and the game ports you allocate.

Add the node in the panel

  1. Go to Admin → Locations and create a location, for example London.
  2. Go to Admin → Nodes and create a node. Enter the domain name that points at the machine, for example node1.example.com, and its memory and disk.
  3. Open the node and add allocations: the IP addresses and ports that servers on this node can use.

The node's page shows the install steps and the exact configure command for that node.

Install the agent

Download it

Download the latest bytepanel-agent-v…-linux-x64.zip from the GitHub releases, then install the binary and service:

unzip bytepanel-agent-v*-linux-x64.zip -d bytepanel-agent
install -m 755 bytepanel-agent/bytepanel-daemon /usr/local/bin/
cp bytepanel-agent/bytepanel-daemon.service /etc/systemd/system/
systemctl daemon-reload

Get a certificate

If the node uses HTTPS and isn't behind a proxy, issue a certificate for its domain:

certbot certonly --standalone -d node1.example.com

Configure and start it

Copy the configure command from the node's page in the panel. It looks like this:

bytepanel-daemon configure --panel https://panel.example.com --token <token>
systemctl enable --now bytepanel-daemon

The command fetches the node's configuration from the panel and writes it to /etc/bytepanel/daemon.json.

Once the agent is running, the node's page shows its OS, CPU and Docker version.

Where things live

PathContents
/etc/bytepanel/daemon.jsonAgent configuration.
/var/lib/bytepanel/volumesServer files.
/var/lib/bytepanel/backupsBackup archives.
/var/log/bytepanelAgent logs.

Run journalctl -u bytepanel-daemon -f to follow the agent's logs.

Edit on GitHub

On this page