Wings
Wings Configuration
Full reference for Wings config.yml and node registration in the panel.
Wings is configured via /etc/pterodactyl/config.yml. The installer symlinks this from /opt/wings/config/config.yml.
Registering a Node
- Log in to the Struxa panel as an admin
- Go to Admin → Nodes → Create New Node
- Fill in the FQDN (e.g.
node.example.com), memory limit, and disk limit - Open the Configuration tab on the node page
- Copy the
token_idandtokenvalues shown there - Paste them into
/etc/pterodactyl/config.yml - Restart Wings
Minimal config.yml
debug: false
uuid: "" # filled in after node creation
token_id: "" # from panel → Admin → Nodes → Configuration
token: "" # from panel → Admin → Nodes → Configuration
api:
host: 0.0.0.0
port: 8080
system:
root_directory: /var/lib/pterodactyl
username: pterodactyl
timezone: UTC
user:
uid: 988
gid: 988
sftp:
enabled: true
bind_port: 2022
docker:
socket: /var/run/docker.sock
network:
name: pterodactyl_nw
driver: bridge
remote: https://panel.example.comKey Configuration Fields
| Field | Default | Description |
|---|---|---|
api.port | 8080 | Port Wings listens on for panel communication |
system.timezone | UTC | Timezone for server logs and schedules |
system.user.uid / gid | 988 | UID/GID of the Wings system user |
system.sftp.bind_port | 2022 | SFTP port for file access |
docker.socket | /var/run/docker.sock | Path to the Docker socket |
remote | — | Full URL of the Struxa panel (must match APP_URL) |
throttles.lines | 2000 | Max console lines per interval before throttling |
throttles.line_reset_interval | 500 | Throttle reset interval in milliseconds |
Starting Wings
cd /opt/wings
docker compose up -d
docker compose logs -fWings logs Successfully connected to panel when the token is valid and the connection is established.
Restarting After Config Changes
cd /opt/wings
docker compose restartThe uuid field in config.yml is populated automatically by Wings the first time it successfully connects to the panel. Do not set it manually.