Creating a New Node

Location

Head to the admin panel and click the Nodes tab on the left sidebar. After that, click 'Create New' on the top right side to open the page to add a node.

Information Required

  • Name: a quick identifiable name for the daemon
  • Description: a long description that is used to help you identify the node.
  • Location: the location you have the node in. These are configured in the 'Locations' section of the panel and one must be created before a node can be created. These simply act as categories for Nodes and serve no other purpose at this time.
  • FQDN: the fully qualified domain name for the node — for example: node.demon.pterodactyl.io
  • Communicate over SSL: if the panel is using SSL the Daemon is required to use SSL as well.
  • Behind Proxy: if you have the daemon behind a proxy that terminates SSL connections before arriving at the daemon then this option should be selected. If none of that sentence made sense, this doesn't effect you.
  • Server File Directory: the location on the physical server where the daemon is to store the files the servers generate. By default this is /srv/daemon-data.

OVH Users

Some OVH users regularly have their /home folder be the largest filesystem. You may want to change to use /home/daemon-data if you are on a default OVH box.

  • Total Memory: the total amount of ram the Node should be able to allocate automatically.
  • Memory Overallocate: the percentage of ram to over-allocate on a Node. For example, if you have set a 10G memory limit, with a 20% overallocation the Panel will allocate up to 12G of memory on this node in total.
  • Total Disk Space: the totaly amount of ram the Node should be able to allocate automatically.
  • Disk Overallocate: works the same way as memory overallocation.

WARNING

Don't forget to account for OS overhead and other software requirements on machines.

  • Daemon Port: the port that the Daemon should listen on.
  • Daemon SFTP Port: the port the daemon sftp-server or standalone SFTP server listen on.

Install the Daemon

At this point you'll need to have the daemon installed on your machine. Check out the documentation for more information, or try one of the community guides for CentOS, Ubuntu, or Debian.

Configuring the Node

Go to the Node Configuration page

Copy and paste the config into the core.json folder. (Default location is /srv/daemon/config/core.json)

Auto-Deploy

This will generate a command to run on the node server to configure the daemon for you. (This needs to be run in the /srv/daemon folder)