hostinger-django-demo/README.md

🚀 Django VPS Deployment Toolkit

Universal toolkit to deploy ANY Django project to VPS with zero configuration.

✨ Features

• 🎯 Universal - Deploy any Django project from GitHub
• 🏷️ Auto-naming - Extracts project name from repo URL
• 🔄 Multi-project - Unlimited Django projects per VPS
• 🔧 Zero config - Automatic nginx + gunicorn + systemd setup
• 🚀 One command - Complete deployment in minutes
• 🔒 Secure - Non-root deployment with proper permissions
• 📡 Auto-deploy - GitHub webhook integration for CI/CD

🚀 Quick Deploy

Setup VPS (Once per VPS)

# 1. Fix SSH after VPS reset
ssh-keygen -f '~/.ssh/known_hosts' -R 'YOUR_VPS_IP'

# 2. Upload and run user setup
scp setup-django-user.sh root@YOUR_VPS_IP:/root/
ssh root@YOUR_VPS_IP "sudo bash /root/setup-django-user.sh"

# 3. Clone this toolkit
ssh root@YOUR_VPS_IP "cd /home/django && git clone https://github.com/thecyberlearn/hostinger-django-demo.git django-vps-toolkit"

Deploy Any Django Project

# Deploy any Django project with one command!
ssh root@YOUR_VPS_IP "cd /home/django/django-vps-toolkit && sudo bash deploy-django-project.sh https://github.com/USER/PROJECT.git"

Examples:

# Deploy a blog
sudo bash deploy-django-project.sh https://github.com/johndoe/my-blog.git
# → Live at: http://YOUR_VPS_IP/my-blog/

# Deploy an e-commerce site  
sudo bash deploy-django-project.sh https://github.com/company/shop-backend.git
# → Live at: http://YOUR_VPS_IP/shop-backend/

# Deploy a portfolio
sudo bash deploy-django-project.sh https://github.com/jane/portfolio-site.git
# → Live at: http://YOUR_VPS_IP/portfolio-site/

🎯 What It Does

1. Extracts project name from GitHub URL
2. Clones project to /var/www/PROJECT_NAME/
3. Creates virtual environment and installs dependencies
4. Runs Django migrations and collects static files
5. Creates systemd service gunicorn-PROJECT_NAME.service
6. Configures nginx for path-based routing
7. Starts everything and tests deployment

📁 Toolkit Files

🚀 Main Scripts:

• deploy-django-project.sh - Deploy any Django project
• setup-django-user.sh - VPS user setup (run once)

🔧 Advanced Features:

• setup-multi-webhook.sh - GitHub auto-deploy webhooks
• webhook-router.py - Multi-project webhook handler
• MULTI_PROJECT_SETUP.md - Advanced webhook guide

📝 Templates:

• templates/nginx.conf.template - Nginx configuration
• templates/gunicorn.service.template - Systemd service
• templates/production_settings.py - Django production settings

🔄 Auto-Deploy Setup

Want GitHub auto-deploy like Render/Vercel?

# Setup webhook system
sudo bash setup-multi-webhook.sh

# Add webhook to your GitHub repos:
# URL: http://YOUR_VPS_IP/webhook  
# Secret: [from setup output]
# Events: Push events

# Now push to GitHub → Auto-deploy! 🚀

💡 Examples

Deploy Multiple Projects

# Each project gets its own URL path
sudo bash deploy-django-project.sh https://github.com/user/blog.git
sudo bash deploy-django-project.sh https://github.com/user/shop.git  
sudo bash deploy-django-project.sh https://github.com/user/api.git

# Results:
# http://YOUR_VPS_IP/blog/
# http://YOUR_VPS_IP/shop/  
# http://YOUR_VPS_IP/api/

Project Management

# Check project status
systemctl status gunicorn-blog.service
systemctl status gunicorn-shop.service

# View project logs
journalctl -u gunicorn-blog.service -f

# Restart project
systemctl restart gunicorn-blog.service

# Update project
cd /var/www/blog && sudo -u django git pull && systemctl restart gunicorn-blog.service

🎯 Requirements

Your Django Project Needs:

• requirements.txt file
• Working manage.py
• Proper Django project structure

VPS Requirements:

• Ubuntu 20.04+ or similar
• Root/sudo access
• 1GB+ RAM recommended

🚨 Troubleshooting

Deployment fails?

# Check logs
journalctl -u gunicorn-PROJECT_NAME.service -f

# Test Django
cd /var/www/PROJECT_NAME
sudo -u django bash -c "source venv/bin/activate && python manage.py check"

# Test nginx
nginx -t

Can't access site?

# Check services
systemctl status gunicorn-PROJECT_NAME.service nginx

# Check firewall
ufw status

🎉 Success!

You now have a universal Django deployment toolkit that can deploy any Django project to VPS with zero configuration!

Just provide a GitHub URL and get a working Django site! 🚀