Skip to content

Justus0405/homelab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Banner

Homelab

Personal homelab configuration, Docker stacks, and utility scripts for managing self-hosted services across Arch Linux and other systems.

Quick Start

  1. Clone the repository:
git clone --depth 1 https://github.com/Justus0405/homelab.git
  1. Navigate to a stacks directory:
cd homelab/docker-compose/vaultwarden
  1. Configure the stack (If needed):
cat .env.example
nano .env
  1. Bring up the stack:
docker-compose up -d

Repository Structure

configs/Arch Linux/

System configuration files for Arch Linux, useful for replicating or restoring a base setup.

File Purpose
bashrc.txt Shell configuration and aliases
fstab.txt Filesystem mount table
grub.txt Bootloader configuration
mirrorlist.txt Pacman mirror list
pkglist.txt Installed package list (for bulk reinstall via pacman -S --needed - < pkglist.txt)

docker-compose/

Each directory contains a docker-compose.yml (and any related notes & .env) for a self-hosted service.

Stack Description
beszel-agent Lightweight server monitoring agent
beszel-server Monitoring dashboard server
duplicati Encrypted backup solution
flame Self-hosted start page and application dashboard
gotify Self-hosted push notification server
immich Photo and video management
jellyfin Media server for movies, TV, and music
jotty Lightweight note-taking app
makemkv Containerized disc ripping tool
nginx-proxy-manager Reverse proxy with SSL and a web UI
torrent-stack Torrent client and related services
uptime-kuma Uptime monitoring and status pages
vaultwarden Lightweight Bitwarden-compatible password manager
watchtower Automatic Docker container updates

scripts/

Utility and setup scripts for common tasks across Arch and other hosts.

Script Description
Arch-docker-eof-fix.sh Fix for Docker EOF errors on Arch
Arch-install-docker.sh Docker installation for Arch Linux
Arch-install-playit.sh Install playit.gg tunnel agent on Arch
Arch-update-playit.sh Update playit.gg on Arch
Debian-install-docker.sh Docker installation for Debian
Debian-install-playit.sh Install playit.gg tunnel agent on Debian
permissions-fixer.sh Bulk fix file/directory permissions
sha256compare.sh Compare SHA-256 checksums for file verification

testing/

Experimental or in-progress stacks not yet promoted to production.

Stack Description
llama LLM inference via llama.cpp
nginx Nginx web server testing
ollama LLM inference via Ollama
openspeedtest Self-hosted network speed test

Copyright © 2026-present Justus0405