This guide is for people looking to migrate from the old Node.JS daemon to Wings. Please see the install guide if you are trying to install Wings for the first time on a new node.
Panel Version Requirement
You must be running Pterodactyl Panel 1.X in order to use Wings.
You'll have a brief offline period as you perform this process, however no running game processes will be affected. Plus, chances are your Panel will be offline (or in maintenance mode) during this so your users should not notice anything out of the ordinary.
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 which will create the base directory and download the wings executable.
mkdir -p /etc/pterodactyl curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64 chmod u+x /usr/local/bin/wings
Once you have installed Wings, you'll need to copy over a new configuration file from the Panel. This file is in a new format, and should be easier for you to manage and edit in the future.
Simply copy and paste the code block and paste it into a file called
config.yml within the
directory and save it.
Please note that any modifications you previously made to the configuration will be lost with this. If you have modifications to our default settings, the best option is to start Wings once with the copied configuration which will then populate all of the other configuration settings.
From there you can make any adjustments as necessary.
Now that Wings is installed, we need to remove all of the old daemon code from the server since it is not being
used anymore. To do this, simply execute the following commands — assuming your old daemon is in the default
# Stop the old daemon. systemctl stop wings # Delete the entire directory. There is nothing stored in here that we actually need for the # purposes of this migration. Remember, server data is stored in /srv/daemon-data. rm -rf /srv/daemon # Optionally, remove NodeJS from your system if it was not used for anything else. apt -y remove nodejs # or: yum remove nodejs
If you've used the standalone SFTP server with the old daemon, we need to remove it's systemd service as well, as it's no longer needed. You can do so using the following commands.
# stop and disable the standalone sftp systemctl disable --now pterosftp # delete the systemd service rm /etc/systemd/system/pterosftp.service
You'll then need to edit your existing
systemd service file for Wings to point to the new control software. To do
/etc/systemd/system/wings.service and replace the entire contents of the file with the following:
[Unit] Description=Pterodactyl Wings Daemon After=docker.service [Service] User=root WorkingDirectory=/etc/pterodactyl LimitNOFILE=4096 PIDFile=/var/run/wings/daemon.pid ExecStart=/usr/local/bin/wings Restart=on-failure StartLimitInterval=600 [Install] WantedBy=multi-user.target
Then, start wings.
systemctl daemon-reload systemctl enable --now wings
What if Wings doesn't start?
If you encounter issues starting Wings at this point, run the following command to start Wings directly and check for any specific error output.
sudo wings --debug