View .md

Command-line tools

The FeatherPanel command-line tools. What the panel CLI, FeatherCli, the installer script and the featherwings binary do, how to install each one, and every command.

On this page

FeatherPanel has four command-line tools. They do different jobs and run in different places, so pick the one that matches what you want to do.

ToolRuns onUse it toReference
Panel CLI (featherpanel, php cli)The panel host, inside the backendRun maintenance: migrations, settings, users, snapshots, cronPanel CLI
FeatherCli (feathercli)Any machine with access to the panel URLControl servers over the API, script backups and files, migrate from PterodactylFeatherCli
Installer (installer.sh)A fresh or existing Linux host, as rootInstall, update and remove the panel, FeatherWings, FeatherQuilld and SSLInstaller script
featherwingsEach game nodeConfigure the daemon, run diagnostics, back up and update the nodeFeatherWings CLI

Install

The installer is the only tool you download by hand. It sets up the other three:

curl -sSL https://get.featherpanel.com/installer.sh | bash
  • Installing the panel with the installer writes the featherpanel wrapper to /usr/local/bin. It runs the panel CLI in the Docker container or in the source install, whichever you chose. See Panel CLI.
  • The installer’s [3] CLI entry downloads FeatherCli to /usr/local/bin/feathercli. You can also fetch the binary from the GitHub releases yourself; see FeatherCli.
  • Installing FeatherWings puts the featherwings binary on the node. See Installing FeatherWings.

Panel CLI commands

Run these on the panel host as featherpanel <command>, or php cli <command> inside the backend.

CommandWhat it does
setupFirst-time setup: database connection, .env file and encryption key
migrateApply pending database migrations
usersInteractive user manager
settingsInteractive settings editor
snapshotsCreate, list and restore database snapshots
cronRun the due cron jobs once
logsUpload the panel logs and print share links for support
moduleEnable optional modules such as phpMyAdmin
saasNon-interactive admin helpers for scripts

The full list, with subcommands and flags, is in the Panel CLI reference.

FeatherCli commands

feathercli config setup          # panel URL and API key
feathercli server list
feathercli server restart --uuid <uuid>
feathercli server backups create --uuid <uuid>
feathercli migrate check --pterodactyl-dir /var/www/pterodactyl
GroupPurpose
configStore and test the panel URL and API key
serverPower, console, logs, reinstall, plus backups, files, databases and schedules
accountSession, SSH keys and notifications
oauth2Build and test OAuth2 integrations
migrateImport a Pterodactyl panel

See FeatherCli for every subcommand and Migrating from Pterodactyl for the migration steps.

Installer flags

The installer is interactive by default. Flags and environment variables let you skip menus or run it unattended, which is how the panel’s node setup command works. Every flag is listed in the installer reference.

featherwings commands

featherwings runs the daemon and has subcommands for configure, diagnostics, node-backup and update. The FeatherWings CLI reference lists every command and flag.