|Ubuntu||14.04||⚠️||Approaching EOL, not recommended for new installations.|
|CentOS||6||🚫||Does not support all of the required packages.|
|Debian||8||⚠️||Requires kernel modifications to run Docker.|
|Alpine Linux||3.4+||⚠️||Not officially supported, but reportedly works.|
|RHEL||7||⚠️||Not officially supported, should work.|
In order to run the Daemon you will need a system capable of running Docker containers. Most VPS and almost all dedicated servers should be capable of running Docker, but there are edge cases.
If your provider makes use of
LXC then you will most likely be unable to
run the Daemon. If you are unsure what your host is using there are a couple of options. The easiest is to check
their website, or reach out to their support team.
If you want to take a different approach, try using
lscpu and checking what the virtualization type listed is. An
example of this is shown below which shows my hypervisor running with full virtualization — this means it will
support Docker without issues. If you see
KVM for the vendor, chances are you're fine as well.
dane@daemon:~$ lscpu | grep 'vendor\|type' Hypervisor vendor: VMware Virtualization type: full
If that doesn't work for some reason, or you're still unsure, you can also run the command below and as long as it
LXC you're probably okay to continue.
dane@daemon:~$ sudo dmidecode -s system-manufacturer VMware, Inc.
Pterodactyl's Daemon requires the following dependencies be installed on your system in order for it to operate.
- Nodejs (
For a quick install of Docker CE, you can execute the command below:
curl -sSL https://get.docker.com/ | CHANNEL=stable bash
If you would rather do a manual installation, please reference the official Docker documentation for how to install Docker CE on your server. Some quick links are listed below for commonly supported systems.
Check your Kernel
Please be aware that some hosts install a modified kernel that does not support important docker features. Please
check your kernel by running
uname -r. If your kernel ends in
probably using a non-supported kernel. Check our Kernel Modifications guide for details.
Start Docker on Boot
If you are on Ubuntu 16 or CentOS run the command below to have Docker start when you boot your machine.
systemctl enable docker
On most systems, docker will be unable to setup swap space, you can check if this is the case by running
If it outputs
WARNING: No swap limit support near the bottom, this is the case. Enabling swap is completely optional,
but we recommended doing it if you will be hosting for others, and to prevent OOM errors.
To do so, open
/etc/default/grub as a root user, and find the line starting with
sure the line includes
After doing that, simply run
sudo update-grub followed by
sudo reboot to restart the server and have swap enabled.
Below is an example of what the line should look like, do not copy this line verbatium, it often has additional
OS specific parameters.
NodeJS is also super easy to install! Simply run the command below to make the package accessible to your system.
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - apt -y install nodejs make gcc g++
Other OS Distributions
Installing Daemon Software
The first step for installing the daemon is to make sure we have the required directory structure setup. To do so, run the commands below.
mkdir -p /srv/daemon /srv/daemon-data cd /srv/daemon
If you are using a server provided by OVH or SoYouStart please be aware that your main drive space is probably allocated to
/home, and not
/ by default. Please consider using
/home/daemon-data for server data. This can be easily
set when creating the node.
The next step is to download the software and unpack the archive.
curl -L https://github.com/pterodactyl/daemon/releases/download/v0.6.7/daemon.tar.gz | tar --strip-components=1 -xzv
Finally, we need to install the dependencies that allow the Daemon to run properly. This command will most likely take a few minutes to run, please do not interrupt it.
npm install --only=production
Once you have installed the daemon and required components, the next step is to create a node on your installed Panel Once you have done that there will be a tab called Configuration when you view the node.
Simply copy and paste the code block and paste it into a file called
/srv/daemon/config and save it.
You may also use the Auto-Deployment feature rather than manually creating the files.
Starting the Daemon
To start your daemon simply move into the daemon directory and run the command below which will start the daemon in
foreground mode. Once you are done, use
CTRL+C to terminate the process. Depending on your server's internet connection
pulling and starting the Daemon for the first time may take a few minutes.
sudo npm start
Daemonizing (using systemd)
If you are using Ubuntu 14 you cannot use
systemd to manage your Daemon. Please see the instructions below on using
"forever" to run the daemon.
Running Pterodactyl Daemon in the background is a simple task, just make sure that it runs without errors before doing
this. Place the contents below in a file called
wings.service in the
[Unit] Description=Pterodactyl Wings Daemon After=docker.service [Service] User=root #Group=some_group WorkingDirectory=/srv/daemon LimitNOFILE=4096 PIDFile=/var/run/wings/daemon.pid ExecStart=/usr/bin/node /srv/daemon/src/index.js Restart=on-failure StartLimitInterval=600 [Install] WantedBy=multi-user.target
Then, run the commands below to reload systemd and start the daemon.
systemctl daemon-reload systemctl enable wings systemctl start wings
Daemonizing (using Forever)
Forever allows us to run the daemon as a pseudo-daemonized application. We can exit our terminal session without killing the process, and we don't have to run it in a screen. Inside the daemon directory, run the commands below which will install forever and then start the process in the background.
You should use this only if your system does not support systemd.
npm install -g forever forever start src/index.js # To stop the daemon use: forever stop src/index.js