Wings is featherpanel's server control plane, built for the rapidly changing gaming industry and designed to be highly performant and secure. Wings provides an HTTP API allowing you to interface directly with running server instances, fetch server logs, generate backups, and control all aspects of the server lifecycle.
In addition, Wings ships with a built-in SFTP server allowing your system to remain free of FeatherPanel specific dependencies, and allowing users to authenticate with the same credentials they would normally use to access the Panel.
FeatherWings is available from the MythicalSystems APT repository in two channels:
| Package | Channel | When |
|---|---|---|
featherwings |
stable | Published GitHub releases (v* tags) |
featherwings-dev |
nightly | Every commit to main |
These packages conflict and cannot be installed at the same time. Switching channels (apt install featherwings ↔ featherwings-dev) replaces the other package automatically.
FeatherWings requires Docker Engine (docker-ce) from Docker's official apt repository. Install Docker before FeatherWings — do not use the distro docker.io package, as it conflicts with docker-ce.
Full Docker install docs: Ubuntu · Debian
- Install Docker Engine (skip if
docker-ceis already installed):
Ubuntu
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now dockerDebian — same steps, but use https://download.docker.com/linux/debian/gpg and https://download.docker.com/linux/debian in the commands above. See the Debian install guide for details.
If you previously installed docker.io or other unofficial Docker packages, remove them first as described in the Docker docs.
- Import the FeatherWings repository GPG key:
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://apt.mythicalsystems.org/repository/keys/public.gpg \
| sudo gpg --dearmor -o /etc/apt/keyrings/mythicalsystems.gpg
sudo chmod a+r /etc/apt/keyrings/mythicalsystems.gpg- Add the repository:
ARCH="$(dpkg --print-architecture)"
echo "deb [arch=${ARCH} signed-by=/etc/apt/keyrings/mythicalsystems.gpg] https://apt.mythicalsystems.org/repository/MythicalSystems/ stable main" \
| sudo tee /etc/apt/sources.list.d/mythicalsystems.list- Install FeatherWings (stable):
sudo apt-get update
sudo apt-get install -y featherwingsOr the nightly build:
sudo apt-get install -y featherwings-dev- Configure and start (if the install wizard did not run automatically):
sudo featherwings configure
sudo systemctl enable --now featherwingsInstall Docker from Docker's official repository first (step 1 above), then:
sudo apt-get update && sudo apt-get install -y ca-certificates curl gnupg && sudo install -d -m 0755 /etc/apt/keyrings && curl -fsSL https://apt.mythicalsystems.org/repository/keys/public.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/mythicalsystems.gpg && sudo chmod a+r /etc/apt/keyrings/mythicalsystems.gpg && ARCH="$(dpkg --print-architecture)" && echo "deb [arch=${ARCH} signed-by=/etc/apt/keyrings/mythicalsystems.gpg] https://apt.mythicalsystems.org/repository/MythicalSystems/ stable main" | sudo tee /etc/apt/sources.list.d/mythicalsystems.list && sudo apt-get update && sudo apt-get install -y featherwingsTo upgrade later:
sudo apt-get update && sudo apt-get install --only-upgrade featherwings
# or for nightly:
sudo apt-get update && sudo apt-get install --only-upgrade featherwings-devIf you previously installed FeatherWings by downloading the binary from GitHub releases, you can switch to APT without reconfiguring the panel.
- Make sure your config is at
/etc/featherpanel/config.yml. If it lives somewhere else, move or copy it there first:
sudo mkdir -p /etc/featherpanel
sudo cp /path/to/your/config.yml /etc/featherpanel/config.yml- Stop the old daemon and ensure Docker Engine (
docker-ce) is installed from Docker's official apt repository (step 1 above):
sudo systemctl stop featherwings 2>/dev/null || true
sudo systemctl stop wings 2>/dev/null || true- Add the FeatherWings APT repository (steps 2–3 above), then install:
sudo apt-get update
sudo apt-get install -y featherwingsIf /etc/featherpanel/config.yml already exists, the package keeps it and restarts the service. You do not need to run featherwings configure again.
- Clean up the old manual install (optional but recommended):
sudo rm -f /etc/systemd/system/featherwings.service
sudo rm -f /etc/systemd/system/wings.service
sudo systemctl daemon-reload
sudo systemctl enable --now featherwingsThe APT package installs the binary to /usr/local/bin/featherwings and provides a wings symlink for older scripts. After migration, use apt upgrade to update instead of replacing the binary by hand.
Feel free to report any wings specific issues or feature requests in GitHub Issues.