Skip to content

README.md

Latest commit

 

History

History
57 lines (41 loc) · 1.35 KB

README.md

File metadata and controls

57 lines (41 loc) · 1.35 KB

Intro to Home Labbing Part 1

Workshop repo for learning how to SSH into a VPS, install Docker, understand Docker Compose, and deploy services.

Contents

  • slideshow/ - Slidev deck used during the workshop
  • examples/ - Docker Compose stacks for practice

Run the slide deck

cd slideshow
bun install
bunx slidev --open

To build static files:

cd slideshow
bun run build

Compose examples

All examples are in examples/<stack-name>/compose.yaml.

Stack Purpose URL/Port
stirling-pdf PDF tools app from workshop http://<vps-ip>:8080
whoami Simple container/port check app http://<vps-ip>:8081
it-tools Handy browser-based networking/dev tools http://<vps-ip>:8082
uptime-kuma Basic service uptime monitoring http://<vps-ip>:3001
linkding Self-hosted bookmark manager http://<vps-ip>:9090

Run any example stack

cd examples/<stack-name>
cp .env.example .env  # only if this file exists
sudo docker compose up -d
sudo docker compose ps

Stop a stack:

sudo docker compose down

Post-workshop practice ideas

  1. Put one stack behind a reverse proxy (Caddy or Traefik).
  2. Add backups for each stack's data volume.
  3. Pin image tags to specific versions (avoid latest).
  4. Add health checks and restart policies where useful.