Cloud Backups — Pterodactyl Cloud Storage Addon
View attachment 1390710
Version: 1.0.0 | Platform: Pterodactyl β2026-06+ (Blueprint Framework)
---
What is Cloud Backups?
Cloud Backups is a premium Pterodactyl addon that extends your panel with automatic cloud storage backups. Connect your users' Google Drive, Dropbox, FTP, or SFTP accounts and push server backups directly to their personal cloud — no more relying solely on Wings-local storage.
Built for game hosts, Minecraft server owners, and any Pterodactyl administrator who wants to offer their users off-server redundancy with zero extra infrastructure.
---
Features
| Feature | Description |
|---------|-------------|
| 4 Cloud Providers | Google Drive, Dropbox, FTP, SFTP |
| OAuth 2.0 | Secure one-click authentication for GDrive & Dropbox |
| Automated Scheduling | Cron-based backup schedules per server |
| One-Click Restore | Download from cloud → push to Wings → restore |
| Encrypted Credentials | FTP/SFTP passwords encrypted at rest |
| Per-User Storage | Each backup goes to the user's own cloud account |
| Native Integration | Uses Pterodactyl's native backup engine under the hood |
| Nebula Theme Ready | Full dark/glassmorphism theme support |
| Queue Worker | Async processing via Laravel queues (Redis) |
| Auto Cleanup | Stale temp files and orphaned records cleaned daily |
| Full API | RESTful API for all operations |
---
Screenshots
None at the moment
---
How It Works
1. Admin configures OAuth apps in Google Cloud / Dropbox Developer Console
2. User connects their cloud account from the server page (one click OAuth)
3. Backup is triggered — Pterodactyl creates a native backup, then uploads it to cloud
4. Restore or Download any backup from the clean dashboard UI
5. Schedule automated backups with custom cron expressions
---
Requirements
- Pterodactyl Panel β2026-05 or later
- Blueprint Framework (latest)
- PHP 8.1+
- Queue worker (Redis recommended)
- Node.js 16+ (for panel asset compilation)
---
Quick Install
Full install guide included in
INSTALL.md.---
API Overview
All endpoints under /api/client/extensions/cloudbackups/{server_uuid}:
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /{server} | List backups & connected providers |
| POST | /{server}/create | Create a new cloud backup |
| GET | /{server}/download/{id} | Download backup as .tar.gz |
| POST | /{server}/restore/{id} | Restore backup to server |
| DELETE | /{server}/{id} | Delete backup from cloud + DB |
| GET | /{server}/auth/{provider} | Get OAuth URL |
| POST | /{server}/disconnect/{provider} | Revoke OAuth tokens |
| GET | /{server}/schedules | List schedules |
| POST | /{server}/schedules/create | Create schedule |
| DELETE | /{server}/schedules/{id} | Delete schedule |
| PATCH | /{server}/schedules/{id}/toggle | Enable/disable schedule |
Full API reference in README.md.
---
Supported Providers
Google Drive
- OAuth 2.0 with refresh token support
- Uploads to user's Drive via
drive.filescope - Multipart upload with metadata
- Token refresh when expired
Dropbox
- OAuth 2.0 with offline access
- Chunked upload for files >150MB
- Full Dropbox or App folder scope
- Token refresh via refresh_token
FTP / SFTP
- Direct server-to-server transfer
- Credentials encrypted with Laravel
encrypt() - Supports passive FTP and SFTP v3
- Port configurable (default 21/22)
---
Security
- All cloud credentials encrypted at rest (Laravel encryption)
- OAuth tokens stored encrypted in database
- Restore files served as single-use downloads
- API authenticated via Pterodactyl Client API keys
- No shared storage — each user uses their own cloud account
---
What's Included
- cloudbackups.blueprint — Ready-to-install extension package
- README.md — Full documentation with API reference
- INSTALL.md — Step-by-step installation guide
- CLOUD_BACKUP_logo.webp — Extension icon
---
Frequently Asked Questions
Q: Does this work with the Nebula theme?
A: Yes! Full glassmorphism theme support included.
Q: Can users share cloud accounts?
A: Each backup goes to the authenticating user's personal cloud. Every user connects their own account.
Q: What happens if Wings is down during a scheduled backup?
A: The queue worker will retry on the next cycle. Backups are processed asynchronously.
Q: Is there a file size limit?
A: Dropbox chunked upload supports files of any size (8MB chunks). Google Drive uses multipart upload. FTP/SFTP streams directly.
Q: Does this replace Pterodactyl's built-in backups?
A: No — it extends them. Cloud Backups uses the native backup engine and uploads the result to cloud storage.
---
Changelog
v1.0.0 — Initial release
- Google Drive, Dropbox, FTP, SFTP cloud storage
- OAuth 2.0 authentication
- Cron-based scheduling
- One-click restore
- Full REST API
- Nebula theme support
---
Support
Documentation included in the download. For issues, contact the developer.
---
Cloud Backups — Built for Pterodactyl by Hacker Dogs
