VPS Deploy Guide

Deploy any Dockerized project to a VPS with GHCR, Nginx, SSL, and auto-deploy. Click any node to jump to its guide.

Overview

Deploy any Dockerized project to a VPS with GHCR, Nginx, SSL, and GitHub Actions auto-deploy.

CI/CD — GitHub Actions to GHCR

Build and push Docker images to GitHub Container Registry on every push to main.

VPS Base Setup

SSH in, update packages, configure firewall.

Docker & GHCR on VPS

Install Docker, authenticate with GitHub Container Registry, pull your image.

Run Containers

Create env file and start your container(s).

Nginx Reverse Proxy

Route traffic from port 80 to your app container.

SSL with Certbot

HTTPS certificates with automatic renewal.

DNS Setup

Point your domain to the VPS.

Auto-Deploy via SSH

GitHub Actions automatically SSHs into your VPS and runs the redeploy script after a successful image push.

Operations & Maintenance

Day-to-day commands for managing your deployment.