Complete collection of automated installation and management scripts for PUQcloud - a modular cloud automation and billing system.
This repository contains production-ready scripts for deploying PUQcloud infrastructure on various Linux distributions. Each script is designed for reliability, security, and ease of use in enterprise environments.
PUQcloud-Scripts/
├── README.md # This file - main navigation
├── Debian_Ubuntu/ # Debian/Ubuntu scripts (Primary)
│ ├── install.sh # 🚀 Main PUQcloud installation
│ ├── phpmyadmin.sh # 🗄️ phpMyAdmin installation
│ ├── delete_and_clear_databases.sh # 🧹 Database cleanup utility
│ ├── install_config.txt # ⚙️ Configuration storage
│ └── docs/ # 📖 Complete documentation
│ ├── README.md # Quick start guide
│ ├── install-guide.md # Detailed installation guide
│ ├── phpmyadmin-guide.md # phpMyAdmin setup guide
│ ├── database-cleanup-guide.md # Database cleanup guide
│ ├── troubleshooting.md # Problem resolution guide
│ └── examples.md # Usage examples & scenarios
├── HestiaCP/ # HestiaCP control panel integration
│ ├── install_hestiacp_admin.sh # 🎛️ HestiaCP + PUQcloud installation
│ ├── install_config_admin.txt # ⚙️ HestiaCP configuration storage
│ └── docs/ # 📖 HestiaCP documentation
│ ├── README.md # HestiaCP setup guide
│ └── README_ADMIN_SCRIPT.md # Detailed admin guide
└── [Future additions] # Docker and more (planned)
# Clone the repository
git clone https://github.com/puqcloud/PUQcloud-Scripts.git
cd PUQcloud-Scripts
# Navigate to your distribution
cd "Debian_Ubuntu"
# Make scripts executable
chmod +x *.sh# Basic installation
sudo ./install.sh your-domain.com admin@domain.com password123 "Admin Name"
# Or interactive mode
sudo ./install.shsudo ./phpmyadmin.sh# Navigate to HestiaCP directory
cd "HestiaCP"
# Make scripts executable
chmod +x *.sh# Combined HestiaCP and PUQcloud installation
sudo ./install_hestiacp_admin.sh| Platform | Version | Status | Stability |
|---|---|---|---|
| Ubuntu/Debian | v1.0 | ✅ Active | 🟢 Production Ready |
| HestiaCP | v1.0 | ✅ Active | 🟢 Production Ready |
| Docker | - | ⏳ Planned | 🟡 In Development |
- 📋 Complete Installation Guide - Detailed setup instructions
- 🗄️ phpMyAdmin Guide - Database management setup
- 🧹 Database Cleanup Guide - Safe database reset procedures
- 🔧 Troubleshooting Guide - Problem resolution
- 💡 Usage Examples - Real-world scenarios
- 🚀 HestiaCP Setup Guide - Quick start with HestiaCP
- 📋 Detailed HestiaCP Guide - Complete installation instructions
- ⚡ Quick Start Guide - Get started in 5 minutes
- 🏗️ Architecture Overview - System design
⚠️ Important Notes - Critical information
# Enterprise-grade installation with monitoring
sudo ./install.sh production.company.com admin@company.com SecurePass123 "System Admin"
sudo ./phpmyadmin.sh# Quick development setup
sudo ./install.sh dev.local dev@localhost.local dev123 "Developer"# Update existing installation
sudo ./install.sh
# Choose "update" when prompted# Full system cleanup and reinstall
sudo ./delete_and_clear_databases.sh
sudo ./install.sh fresh.domain.com admin@domain.com NewPass123 "Fresh Admin"# Install HestiaCP with PUQcloud integration
sudo ./install_hestiacp_admin.sh- OS: Debian 11+ or Ubuntu 20.04+
- RAM: 2GB (4GB+ recommended)
- Storage: 10GB free space
- CPU: 1 core (2+ recommended)
- Network: Internet access for downloads
- ✅ Debian 11 (Bullseye)
- ✅ Debian 12 (Bookworm)
- ✅ Ubuntu 20.04 LTS (Focal Fossa)
- ✅ Ubuntu 22.04 LTS (Jammy Jellyfish)
- ✅ Ubuntu 24.04 LTS (Noble Numbat)
- 🛡️ Automatic Security Updates: System packages kept current
- 🔐 SSL Encryption: Let's Encrypt certificates with auto-renewal
- 🔑 Strong Passwords: Random password generation for database users
- 🚪 Firewall Configuration: UFW setup with minimal required ports
- 👤 User Isolation: Proper file permissions and user separation
- 📝 Audit Logging: Comprehensive logging for security monitoring
We welcome contributions! Here's how you can help:
- Create an issue for bugs or feature requests
- Provide detailed system information and error logs
- Include steps to reproduce the problem
- Fork the repository
- Create a feature branch:
git checkout -b feature-name - Make your changes with clear commit messages
- Submit a pull request with detailed description
- Fix typos or clarify instructions
- Add new examples or use cases
- Translate documentation to other languages
- 📋 GitHub Issues: Report problems
- 📖 Documentation: doc.puq.info
- 💬 Community Forum: forum.puqcloud.com
- 📧 Email Support: support@puqcloud.com
- 🌐 PUQcloud Main Project: github.com/puqcloud/PUQcloud
- 📦 Official Website: puqcloud.com
- Backup your data - Scripts may modify system configurations
- Test in development - Verify compatibility before production use
- Review permissions - Scripts require root access for system changes
- Check requirements - Ensure minimum system specifications are met
- Scripts generate random passwords for database users
- All communications encrypted with SSL/TLS
- Regular security updates included in maintenance
- Follow principle of least privilege for user accounts
- Regular Updates: Run update mode monthly
- Backup Schedule: Implement automated backup strategy
- Monitoring: Set up health checks and alerting
- Log Management: Configure log rotation and retention
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
- ✅ Commercial Use: Allowed
- ✅ Modification: Allowed
- ✅ Distribution: Allowed
- ✅ Private Use: Allowed
- ❗ Liability: Limited
- ❗ Warranty: None
Special thanks to:
- PUQcloud Development Team - Core application development
- Community Contributors - Bug reports, feature requests, and testing
- Open Source Projects - LEMP stack components and tools
- Beta Testers - Production environment validation
Built with ❤️ by the PUQcloud Team