https://github.com/nightfury-supreme/petrodash
PetroDash: A clean, customizable dashboard for managing your Pterodactyl servers.
https://github.com/nightfury-supreme/petrodash
client dashboard docker free games nextjs nodejs paypal pterodactyl pterodactyl-api pterodactyl-clientpanel pterodactyl-dashboard tailwindcss typescript
Last synced: about 1 month ago
JSON representation
PetroDash: A clean, customizable dashboard for managing your Pterodactyl servers.
- Host: GitHub
- URL: https://github.com/nightfury-supreme/petrodash
- Owner: NightFury-Supreme
- License: apache-2.0
- Created: 2025-09-04T05:49:55.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-17T02:15:14.000Z (8 months ago)
- Last Synced: 2025-10-17T09:03:50.122Z (8 months ago)
- Topics: client, dashboard, docker, free, games, nextjs, nodejs, paypal, pterodactyl, pterodactyl-api, pterodactyl-clientpanel, pterodactyl-dashboard, tailwindcss, typescript
- Language: TypeScript
- Homepage:
- Size: 739 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
- Support: .github/SUPPORT.md
Awesome Lists containing this project
README
# PteroDash - Premium Control Panel
A modern, feature-rich control panel for Pterodactyl servers with advanced user management, plan-based access control, integrated payment systems, resources shop, comprehensive advertising monetization and more.
# 🌟 All Features
* **Resource Management** – Create servers, manage CPU, RAM, Disk, and allocations
* **Servers** – Create, view, and edit servers with ease
* **User System** – Authentication, password reset, OAuth login, and permissions
* **Email Verification** – Secure email verification system
* **Password Reset** – forgot password functionality with email codes
* **Email Notifications** – Comprehensive email system for account events, security alerts, and notifications
* **Support Tickets** – Complete ticketing system with categories, priority assignment, and admin management
* **Coupons** – Discount codes for plans and promotions
* **Store** – Buy resources and plans using coins
* **Dashboard** – View resources, plans, and live server status
* **Plans** – Lifetime plan support
* **Payment Integration** – PayPal with automatic webhook handling
* **Advertising System** – Google AdSense integration with ad blocker detection
* **Admin Tools** – User banning, egg and location management, analytics, and shop control
* **Security** – JWT auth, OAuth, rate limiting, audit logs, validation, and enhanced security measures
* **UI/UX** – Modern Tailwind CSS dashboard with smooth client-side navigation
* **System Updates**: One-click updates with GitHub integration
* **Gift Coupons** – Share coins and rewards with redeemable codes
## 🚀 Setup & Deployment
Quick links:
- [Docker installation (recommended)](INSTALL.md)
- [Manual installation (not recommended)](INSTALL.md)
## ⚙️ Configuration
### Environment Variables
#### Backend (.env)
```env
# Server Configuration
PORT=4000
# Database
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
# JWT
JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
# Pterodactyl Panel
PTERO_BASE_URL=http://your-panel-ip
PTERO_APP_API_KEY=your-pterodactyl-api-key
# Frontend URL (for CORS)
FRONTEND_URL=https://your-dashboard-domain.com
```
#### Frontend (.env.local)
```env
NEXT_PUBLIC_API_BASE=https://your-api-domain.com
```
## 🏗️ Project Structure
```
pterodash/
├── backend/ # Express.js API server
│ ├── src/
│ │ ├── models/ # Mongoose models (Settings, Users, etc.)
│ │ ├── routes/ # API endpoints (ads, admin, auth, etc.)
│ │ ├── middleware/ # Auth, validation, rate limiting
│ │ ├── services/ # Pterodactyl, PayPal integration
│ │ └── lib/ # Utilities and helpers
│ └── package.json
├── frontend/ # Next.js 15 frontend
│ ├── src/
│ │ ├── app/ # App router pages
│ │ ├── components/ # React components
│ │ │ └── admin/ # Admin components
│ │ ├── hooks/ # Custom React hooks
│ │ ├── styles/ # CSS files (adblocker-modal.css)
│ │ └── types/ # TypeScript definitions
│ └── package.json
└── README.md
```
### Environment Setup (Production)
1. Set `NODE_ENV=production`
2. Configure production MongoDB URI
3. Set up SSL certificates
4. Configure reverse proxy (Nginx/Apache)
5. Set up PM2 or similar process manager
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
### Development Setup
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request
## 📝 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- **Pterodactyl Panel** - For the excellent server management platform
- **Next.js** - For the amazing React framework
- **Tailwind CSS** - For the beautiful utility-first CSS framework
- **MongoDB** - For the flexible NoSQL database
## 📞 Support
- **Discord**: https://discord.gg/vQzbuQD7Xp
- **Documentation**: [Wiki](https://github.com/NightFury-Supreme/PetroDash/wiki)
- **Issues**: [GitHub Issues](https://github.com/NightFury-Supreme/PetroDash/issues)
- **Email**: support@auto-manager.tk
## 🔄 Changelog
See [CHANGELOG.md](CHANGELOG.md) for a detailed history of changes.
---
**Made with ❤️ by the PteroDash Team**
*Star this repository if you find it helpful!*