Creating a node on Pterodactyl

In this guide, we will see how to create a node on your Pterodactyl panel.
Nodes allow you to link your Pterodactyl panel to your physical servers or VPS in order to host game servers.

1. Access the nodes section

Log in to your administrator panel (https://votre_panel.fr/admin).
In the side menu, click on Nodes.
Then click on the Create Node button at the top right.

You will be taken to the node configuration page.

2. Fill in the general information

Name

Name of your node (example: Node-1-Paris).

Description

A short description (optional).

Location

Select the location associated with this node (previously defined in the Locations section).

FQDN (Fully Qualified Domain Name)

The public address of your node (example: node1.your-domain.com).
You can also enter the server's IP address.

Important

If you are using SSL, the FQDN must point to the domain configured with a valid certificate.

Communications

Choose whether the node uses SSL (HTTPS) or not.
Recommended: always use SSL for greater security.

3. Network configuration

Daemon Port

Default: 8080.
This is the communication port between the panel and Wings.

Daemon SFTP Port

Default: 2022.
Used for SFTP access to hosted game servers.

Make sure the selected ports are open in the server's firewall.

4. System Configuration

Total Memory

The total amount of RAM (in MB) that this node can allocate to servers.
Example: 16384 for 16 GB of RAM.

Total Disk Space

Total disk space (in MB) that this node can distribute.
Example: 500000 for 500 GB.

Over-Allocation

Allows you to exceed the RAM or disk limit for over-allocation.
Set to 0 if you do not want to exceed.

Tip

Over-allocation is useful for optimizing your resources, but be careful of overloads if all servers are running at the same time.

5. Save the node

Once all the information has been filled in:

Click Create Node.
The panel will then generate a Wings configuration that you will need to install on your server/VPS.

6. Install Wings on the server

On your server (the future node), run:

sudo mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
sudo chmod u+x /usr/local/bin/wings
sudo wings --debug

Then create the configuration file generated by the panel (/etc/pterodactyl/config.yml) and start Wings:

sudo systemctl enable --now wings
systemctl start wings

7. Checks

In the panel, check that the node displays the Online status.
Also check the Wings logs on the server:

journalctl -u wings -f

✅ Conclusion

You have now added a new node to your Pterodactyl panel and connected it to your server via Wings. You can now easily deploy game servers from your panel.