Allocations

Give your nodes the addresses and ports that players connect to.

An allocation is one IP address and one port on a node. Every game server needs at least one before anybody can connect.

Where they live

Go to Admin > Network, which lists every allocation on every node.

There is no allocations tab on the node page. All allocation work happens here.

The page shows four counts at the top: Total Allocations, Assigned, Available, and Unique IPs. Below them, the allocations are grouped by node and IP address.

Register the address first

An allocation belongs to an IP address that the node knows about. Register the IP address before you add ports.

1. On Admin > Network, open Manage Node IPs.
2. Select the node.
3. Click Add IP.
4. Enter the IP Address.
5. Select a type: Public, Internal, or Floating.
6. Enter an Alias for a friendly name. The alias is optional.
7. Click Add.

Type	Use it for
Public	An address that players reach from the internet.
Internal	An address on a private network between your machines.
Floating	An address that you can move between machines.

One IP address on a node is the Primary address. The panel marks it in the list.

To remove an IP address, click the bin icon on its row.

Adding allocations

1. On Admin > Network, click Add Allocations.
2. Select the Node.
3. Select the IP Address. To register a new address here, select + Add new IP....
4. Enter an IP Alias. The alias is optional.
5. Enter the Port Start.
6. Enter the Port End for a range. Leave it empty for one port.
7. Enter Notes. The notes are optional.
8. Click Create.

A range from 25565 to 25600 creates 36 allocations, one for each port.

Do not create more than 1000 allocations at one time.

If a port already exists on that IP address, the panel skips it and tells you which ports it skipped.

Reading the list

Each port appears as a small block with a colour:

Colour	Meaning
Green	A game server uses this port. The block shows the server name.
Blue	A database host reserves this port.
Grey	The port is free.

Use the search field to find an IP address, a port, or a server name. Use the node list to show one node only. Tick Unassigned only to hide the ports that are in use.

Deleting allocations

You can delete a free port only. A port that a server uses does not show a delete control. Remove the port from the server first.

To delete one port, move the pointer over the block and click the red X. Confirm in the dialog.

To delete every free port on one node:

1. Select the node in the node list.
2. Click Clear Unused.
3. Confirm with Delete unassigned.

This action leaves the ports that servers use.

Giving one to a server

You can assign an allocation in two ways:

• When you create the server. The wizard asks for an allocation on the node that you chose. The panel can also pick the first free one for you.
• After you create the server. Open the server and go to its Network tab.

An allocation must be on the same node as the server.

Primary and extra allocations

Each server has one primary allocation and can have more.

The primary allocation is the address that players use. The panel shows it on the server page and marks it with a Primary badge.

Additional allocations give a server more ports. Some games need a game port, a query port, and an RCON port.

On the Network tab of a server:

• Click the star icon on an allocation to make it the primary one.
• Click the remove icon to give a port back to the node. You cannot remove the primary allocation.

WARNING

A port that you give back returns to the free pool of the node. Another server can take it. You are not certain to get the same port again.

Firewall

An allocation in the panel does not open the port on the node. Make sure that these points are true:

• The port is open in the firewall of the node (ufw, firewalld, iptables, or Windows Firewall).
• Any firewall outside the machine allows the port. Check the security groups of your cloud provider.
• The port is open for both TCP and UDP if the game needs both. Most game servers use UDP for the game traffic.

If players cannot connect, look at the firewall first.

Planning your ports

Give each game type its own range.

Game	Port range
Minecraft	25565-25599
Rust	28015-28049
ARK	7777-7799
Valheim	2456-2479
Source games	27015-27099

Leave space between the ranges, because some games need several ports next to each other. Keep a record of what each range is for.

Next steps

• Server Management - create a server and give it an allocation
• Linux Nodes - add a node