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.sh

sudo ./phpmyadmin.sh

# Navigate to HestiaCP directory
cd "HestiaCP"

# Make scripts executable
chmod +x *.sh

# Combined HestiaCP and PUQcloud installation
sudo ./install_hestiacp_admin.sh

• 📋 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

1. Backup your data - Scripts may modify system configurations
2. Test in development - Verify compatibility before production use
3. Review permissions - Scripts require root access for system changes
4. 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