Wings Setup - Fedora 44

Setup guide for Pelican Wings on a Fedora 44 server.

Prerequisites

• Fedora 44 server
• Root or sudo access
• Panel URL and token ready

---

Expand Root Filesystem

If your root partition has unused space from a previous LV, expand it to fill available space:

sudo lvextend -r -l +100%FREE /dev/mapper/fedora-root

---

Firewall

sudo firewall-cmd --permanent --add-port=443/tcp
sudo firewall-cmd --permanent --add-port=41000-41030/tcp
sudo firewall-cmd --permanent --add-port=41000-41030/udp
sudo firewall-cmd --reload

---

Docker

Remove any existing Docker installation:

sudo dnf remove -y docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-selinux docker-engine-selinux docker-engine

Add Docker repo and install:

sudo dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Enable Docker and add your user to the docker group:

sudo systemctl enable --now docker
sudo usermod -aG docker $USER

Log out and back in for the group change to take effect.

---

Wings

Create directories and install Wings:

sudo mkdir -p /etc/pelican /var/run/wings
sudo curl -L -o /usr/local/bin/wings "https://github.com/pelican-dev/wings/releases/latest/download/wings_linux_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')"
sudo chmod u+x /usr/local/bin/wings

Create the systemd service:

sudo tee /etc/systemd/system/wings.service > /dev/null <<EOF
[Unit]
Description=Wings Daemon
After=docker.service
Requires=docker.service
PartOf=docker.service

[Service]
User=root
WorkingDirectory=/etc/pelican
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
EOF

Enable and start Wings:

sudo systemctl daemon-reload
sudo systemctl enable --now wings

---

Configure Wings

Copy the config from your Panel: Admin > Locations > your node > config.yml

sudo nano /etc/pelican/config.yml

Paste the config, save, then restart Wings:

sudo systemctl restart wings