A modern, open-source web hosting control panel β manage servers, websites, users, and SSL certificates with ease. Built on a Django REST API backend and a React frontend, and ready for containerized deployment with Docker.
Alterion Panel offers a wide range of features for server management:
- Authentication & Access: OAuth2 login with username/email/phone support
- Dashboard & Widgets: Customizable dashboard with alerts, uptime, performance, and activity widgets
- Node Management: SSH agent onboarding and WebSocket-based metrics API
- Web-based Terminal: Local PTY and remote SSH terminal access
- File Manager: SFTP integration with upload/download and file operations
- Secret Manager: Secure project/environment secrets with versioning
- System Monitoring: CPU, memory, disk, and process alerts
- Uptime Monitoring: Real-time checks with database history
- Performance Metrics: Agent-based metrics collection using psutil
- Prometheus Integration: Custom exporter with alert rules
- Service Management: systemctl control for remote services
- SSL Automation: Let's Encrypt/Certbot integration
- Background Jobs: Celery workers for async tasks
- Domain Management: WHOIS lookup and DNS verification
- Installer: GUI installer with SSL, database, and superuser setup
- Docker Support: Containerized deployment options
- Crypto Utilities: Encrypted storage and key management
- Docker and Docker Compose
- (Optional for manual setup) Python 3.8+, Node.js 16+, PostgreSQL or SQLite, Redis
Alterion Panel is designed for containerized deployment with Docker and Kubernetes. The easiest way to get started is using Docker Compose:
-
Clone the repository:
git clone https://github.com/Chace-Berry/Alterion_Panel.git cd Alterion_Panel -
Run Docker Compose:
cd docker docker-compose up --buildThe panel will be available at
http://localhost:13527
For a user-friendly, guided setup experience, download and run the Alterion Webpanel Installer:
- Download the latest installer from the Releases page
- Run
Alterion.Webpanel.Installer.exe(Windows) or the appropriate installer for your platform - Follow the on-screen instructions for SSL setup, database configuration, and superuser creation
- Open your browser and navigate to
http://localhost:13527(Docker) Please not that apis require https so a reverse proxy with tls would be advised in this project we used nginx if you would like a free domain go and check out Digital Plat Dev's free domains - Log in with the superuser credentials you created during setup
- Add a Node: Use the node onboarding feature to connect servers via SSH
- Monitor Systems: View real-time metrics and alerts on the dashboard
- Manage Files: Use the integrated file manager for SFTP operations
- Deploy Applications: Utilize the page builder for no-code deployments
- Configure Services: Control system services remotely
- Issues: Report bugs and request features via GitHub Issues
- Discussions: Join community discussions on GitHub Discussions
- Email: Contact the maintainer at chaceberry686@gmail.com
We welcome contributions! Please see our Contributing Guidelines for details on:
- Setting up a development environment
- Code style and standards
- Submitting pull requests
- Reporting issues
- Follow the installation steps above
- Create a feature branch:
git checkout -b feature/your-feature - Make your changes and test thoroughly
- Submit a pull request
This project is licensed under the Alterion Public Use License (APUL) - see the LICENSE file for details.
- Built with modern web technologies for efficient server management
- Special thanks to the open-source community