🚀 Server Setup & Hosting Automation

A comprehensive guide and automation toolkit for setting up secure, production-ready VPS servers with automated deployment capabilities for Laravel, Vue.js, and Next.js applications.

📋 Table of Contents

• Features
• Quick Start
• Prerequisites
• Installation
• Usage
• Project Types
• GitHub Actions Integration
• Security Features
• Backup & Recovery
• Monitoring
• Contributing
• License

✨ Features

• 🔒 Secure Server Setup: SSH key authentication, firewall configuration, and security hardening
• 🌐 Multi-Stack Support: Laravel (PHP), Vue.js (SPA), and Next.js (SSR) applications
• 🔧 Automated Configuration: One-command project creation with database setup
• 📦 SSL/TLS: Automatic Let's Encrypt certificate generation and renewal
• 🔄 CI/CD Ready: GitHub Actions workflows for automated deployment
• 💾 Backup System: Automated backups with restore capabilities
• 📊 Monitoring: Built-in performance monitoring tools
• 🔐 Database Management: MySQL with phpMyAdmin integration
• 📁 FTP Support: Secure FTP server configuration

🚀 Quick Start

1. Clone this repository:

   git clone https://github.com/yourusername/server-setup-automation.git
   cd server-setup-automation

2. Run the initial server setup:

   chmod +x scripts/initial-setup.sh
   ./scripts/initial-setup.sh

3. Create your first project:

   sudo bash scripts/create-project.sh example.com laravel

📋 Prerequisites

• Ubuntu 20.04+ VPS server
• Root access to the server
• Domain name pointing to your server's IP
• SSH client on your local machine

🛠 Installation

Manual Installation

Follow the step-by-step guide in docs/INSTALLATION.md for detailed installation instructions.

Automated Installation

Use the provided scripts for automated setup:

# Initial server setup
./scripts/initial-setup.sh

# Install automation tools
./scripts/install-automation.sh

📖 Usage

Creating New Projects

# Laravel project
sudo bash scripts/create-project.sh yourdomain.com laravel

# Vue.js project
sudo bash scripts/create-project.sh yourdomain.com vue

# Next.js project
sudo bash scripts/create-project.sh yourdomain.com next

Managing Projects

# List all projects
./scripts/list-projects.sh

# Backup a project
./scripts/backup-project.sh yourdomain.com

# Restore from backup
./scripts/restore-backup.sh

🎯 Project Types

Laravel Projects

• PHP 8.2 with FPM
• MySQL database with automatic user creation
• phpMyAdmin with HTTP authentication
• Composer dependency management
• Laravel-specific optimizations

Vue.js Projects

• Static file serving with Nginx
• Asset optimization and caching
• SEO-friendly configuration
• Build process automation

Next.js Projects

• PM2 process management
• Automatic port assignment
• Static asset optimization
• Server-side rendering support

🔄 GitHub Actions Integration

This repository includes ready-to-use GitHub Actions workflows for automated deployment:

• Laravel Deployment: .github/workflows/laravel-deploy.yml
• Vue.js Deployment: .github/workflows/vue-deploy.yml
• Next.js Deployment: .github/workflows/nextjs-deploy.yml

Required Secrets

Configure these secrets in your GitHub repository:

• SSH_PRIVATE_KEY: Your server's SSH private key
• SERVER_HOST: Your server's IP address or domain
• SERVER_PORT: SSH port (default: 22)
• SERVER_USER: SSH username (default: admin)
• SUDO_PASSWORD: Sudo password for the server user

🔒 Security Features

• SSH Key Authentication: Password-less login with ED25519 keys
• Firewall Configuration: UFW with minimal required ports
• SSL/TLS Encryption: Automatic Let's Encrypt certificates
• Database Security: Secure MySQL configuration
• File Permissions: Proper ownership and permission settings
• HTTP Authentication: phpMyAdmin access protection

💾 Backup & Recovery

Automated Backups

Backups run automatically every Friday at 2:00 AM and include:

• Web files (/var/www)
• Nginx configuration (/etc/nginx)
• MySQL databases (/var/lib/mysql)

Manual Backup

./scripts/backup-project.sh yourdomain.com

Restore from Backup

./scripts/restore-backup.sh

📊 Monitoring

Built-in monitoring tools:

• htop: System resource monitoring
• vnstat: Network usage tracking
• PM2: Process monitoring (for Next.js projects)

🤝 Contributing

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

See CONTRIBUTING.md for detailed guidelines.

📄 License

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

🆘 Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions

🙏 Acknowledgments

• Let's Encrypt for free SSL certificates
• Nginx for the web server
• PM2 for process management
• GitHub Actions for CI/CD

---

Made with ❤️ for developers who value automation and security