VPS Deploy Template

vijitdua.com/projects/vps-deploy-template  ·  vijitdua.com

Production-ready boilerplate to containerize and deploy any app to a VPS over SSH — with optional Cloudflare Tunnel routing.

Install

Copy the contents of vps-deploy-template/ (.github, Dockerfile, docker-compose.yml) into the root of your application repository, then configure the Dockerfile and compose file for your stack.

What you get

• Docker & Docker Compose — normalize runtime; adapt build steps and services for Node, Python, Go, PHP, etc.
• GitHub Actions — build on CI, ship images to your VPS over SSH (no registry required).
• Cloudflare Tunnels (optional) — route traffic without opening 80/443 on the VPS.

Setup

1. Copy the files into your app repo root.
2. Configure the Dockerfile for your language and framework.
3. Edit docker-compose.yml — services, ports, dependencies.
4. Set Variables and Secrets per the GitHub Actions setup guide.

How deployment works

When you push to your deploy branch (default in the workflow: production):

1. GitHub Actions authenticates to your VPS via SSH.
2. Your ENV_FILE secret is written on the server.
3. Images are built on the runner, exported, copied to the VPS, and loaded with docker load.
4. docker-compose up -d replaces containers with minimal downtime.

See the root README sections in this repo for more detail on each step.

Branches

Branch	Use
releases	Production line; default branch
develop	Integration; send PRs here

Contributing

Listed on vijitdua.com/open-source. See CONTRIBUTING.md.

Need	Where
Bug / feature	GitHub issues — include workflow run URL and logs when reporting deploy bugs
Security	SECURITY.md
Templates	Issue · PR

Docs

• CHANGELOG.md
• GitHub Actions setup guide

Links

• Project: https://vijitdua.com/projects/vps-deploy-template
• Author: https://vijitdua.com
• Contribute: https://vijitdua.com/open-source/contributing
• Security: https://vijitdua.com/open-source/security