Selective Restore for Pterodactyl Panel
Restore individual files or folders from any Pterodactyl backup — no full restore required.Selective Restore is a Pterodactyl Panel addon that adds a new "Selective Restore..." menu item to the backup dropdown, letting your users pick exactly which files and folders to restore from a backup archive instead of being forced to wipe and restore the entire server.
Why this exists
Pterodactyl's built-in restore is all-or-nothing — the whole archive is extracted on top of the server. If a user only needs one file back (a config, a single world, a plugin), they have to roll back the entire server. This addon lets them recover just what they need.Key features
- Tree-view picker with search, expand/collapse, and indeterminate folder state
- Optional "delete existing files" toggle (default off) — wipes the selected paths before restoring, for a byte-for-byte match with the backup
- Streams the archive directly from your backup storage (local or S3) using Pterodactyl's existing signed-download mechanism — no re-uploads, no extra credentials
- Supports ustar, GNU long-name, and pax extended tar headers
- Server is locked (restoring_backup status) during the operation, same as vanilla restore
- Reuses the existing backup.restore permission — no new permission surface, no subuser changes needed
- Action is recorded in the activity log
- Vanilla "Restore Backup" button is untouched — selective restore is purely additive
Compatibility
- Pterodactyl Panel (latest 1.x)
- Works with local backup adapter and S3 backup adapter out of the box
- Panel-only addon — no Wings modifications, no node-side changes, no daemon redeploy required
Installation
One-line installer:
Code:
sudo ./install.sh --pterodactyl-dir /var/www/pterodactylThe installer is fully idempotent (safe to re-run) and ships with a matching uninstaller that reverses every change cleanly. Indonesian and English manual-installation guides are included.
What's included
- Full PHP + TypeScript source code
- Installer + uninstaller scripts
- Patcher tool for the small set of vanilla files that need to know about the addon
- Indonesian + English documentation
- License + changelog
What's NOT included
- Pterodactyl Panel itself (you install this on YOUR Pterodactyl)
- Wings modifications (none needed)
