QuickVPS - VPS Configuration Tool

A comprehensive bash script collection for quickly setting up and managing VPS servers with support for multiple web stacks including Laravel, WordPress, Node.js, Docker applications, and more.

🚀 Features

• 🖥️ Server Management: System updates, security hardening, firewall configuration
• 👥 User Management: Create/delete users, manage SSH keys, sudo permissions
• 🌐 Domain Management: Multi-stack support with automatic Nginx configuration
• 🗄️ Database Management: MySQL/MariaDB installation, database creation, backup/restore, optimization
• 🐳 Docker Support: Pre-configured Docker applications (Ghost, n8n, etc.)
• 🔒 SSL/TLS: Automatic Let's Encrypt certificate installation
• 📦 Stack Support: Laravel, WordPress, Node.js, PHP, Static sites
• 🔐 Security: Best practices with proper user permissions and security headers

📋 Requirements

• Ubuntu 20.04+ (Tested on Ubuntu 22.04)
• Root or sudo access
• Internet connection

🛠️ Installation

# Clone the repository
git clone https://github.com/yourusername/QuickVPS.git
cd QuickVPS

# Make the script executable
chmod +x setup.sh

# Run the setup
sudo ./setup.sh

🎯 Usage

Main Menu Options

1. Server Setup: Initial server configuration, security hardening
2. User Management: Create/manage users and SSH access
3. Domain Setup: Configure domains with various web stacks
4. Database Management: MySQL/MariaDB installation, database creation, backup/restore
5. Docker Apps: Deploy pre-configured Docker applications

Stack Types Supported

Stack	Description	Features
Laravel	PHP Laravel Framework	Composer, .env setup, artisan commands, proper permissions
WordPress	WordPress CMS	MySQL/MariaDB integration, wp-config setup
Node.js	Express.js applications	PM2 process manager, automatic startup
PHP	Native PHP applications	PHP-FPM integration
Static	Static HTML/CSS/JS sites	Basic nginx configuration
Docker	Containerized applications	Docker Compose, volume management

Example: Setting up Laravel Application

sudo ./setup.sh
# Select: 3) Domain Setup
# Select: 2) Add Domain
# Enter domain: yourdomain.com
# Select stack: 2) Laravel
# Choose to clone from Git: y
# Enter repository URL: https://github.com/yourusername/laravel-app.git

🏗️ Project Structure

QuickVPS/
├── setup.sh                 # Main entry script
├── modules/
│   ├── server.sh            # Server configuration
│   ├── user.sh              # User management
│   ├── domain.sh            # Domain and stack setup
│   ├── docker.sh            # Docker applications
│   └── utils.sh             # Utility functions
├── templates/
│   ├── nginx_*.conf.template # Nginx configuration templates
│   ├── *.php/.html          # Default files for stacks
│   └── docker/              # Docker compose templates
│       ├── ghost/
│       └── n8n/
├── README.md
└── CHANGELOG.md

🔧 Configuration Templates

Nginx Templates

• nginx_laravel.conf.template - Laravel with proper rewrite rules
• nginx_wordpress.conf.template - WordPress with PHP-FPM
• nginx_node.conf.template - Node.js reverse proxy
• nginx_docker.conf.template - Docker container proxy
• nginx_static.conf.template - Static site serving

Docker Applications

• Ghost: Blog platform with MySQL
• n8n: Workflow automation platform
• More templates can be added in templates/docker/

🔒 Security Features

• Automatic firewall (UFW) configuration
• SSH key-based authentication setup
• Fail2ban integration for brute force protection
• Security headers in Nginx configurations
• Non-root user execution for applications
• Proper file permissions and ownership

🚀 Quick Start Examples

1. Basic Server Setup

sudo ./setup.sh
# Select: 1) Server Setup
# Follow prompts for timezone, packages, firewall

2. Create New User with SSH Access

sudo ./setup.sh
# Select: 2) User Management
# Select: 1) Add User
# Enter username and configure SSH access

3. Deploy WordPress Site

sudo ./setup.sh
# Select: 3) Domain Setup
# Select: 2) Add Domain
# Enter domain name
# Select: 3) WordPress
# Configure database and admin user

4. Setup Database for Laravel

sudo ./setup.sh
# Select: 4) Database Management
# Select: 2) Create Database
# Enter database name: myapp_production
# Enter username: myapp_user
# Select: 1) Generate random password
# Credentials will be saved to /root/db_credentials_myapp_production.txt

5. Deploy Docker Application

sudo ./setup.sh
# Select: 4) Docker Apps
# Select application (Ghost, n8n, etc.)
# Configure ports and environment

🐛 Troubleshooting

Common Issues

1. Permission Denied (Git Clone)

   • Use HTTPS URL instead of SSH: https://github.com/user/repo.git
   • Or setup SSH keys for the server

2. Composer/Artisan Permission Issues

   • Script automatically handles this by running as www-data user
   • Fallback to root with proper warnings if needed

3. Nginx Configuration Issues

   • Check /var/log/nginx/error.log
   • Verify domain DNS points to server IP

4. SSL Certificate Issues

   • Ensure domain is properly pointed to server
   • Check port 80/443 are open in firewall

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Nginx community for excellent documentation
• Laravel community for deployment best practices
• Docker community for containerization standards

📞 Support

If you encounter any issues or have questions:

1. Check the Issues page
2. Create a new issue with detailed information
3. Include server OS, error messages, and steps to reproduce

---

Made with ❤️ for the DevOps community