Security

8 scripts
security

Read-only forced-command SSH reader for a Git vault

Give cluster services and AI agents safe read-only access to a canonical vault via an SSH forced command — status, read, and search only, reporting the commit on every call, with no shell and no write path.

security

Vault secret store + Git history scrub

Set up a pointers-not-values secret pattern with a pre-commit guard, and purge a secret that was already committed from all Git history with git-filter-repo.

securityTested

ClamAV Download Scan + Auto-Purge (Docker)

Run ClamAV in a container to scan your download folder, delete executables that masquerade as media, and quarantine infected files on a schedule.

securityTested

Block SSH brute-force with fail2ban (Linux)

Install fail2ban and configure an SSH jail that auto-bans IPs after repeated failed login attempts. Works on Ubuntu, Debian, Fedora, and openSUSE.

securityTested

Generate a self-signed TLS certificate (Linux / macOS / Windows)

Create a self-signed TLS certificate and private key with OpenSSL for internal homelab services. Includes Subject Alternative Names so modern browsers accept it.

securityTested

SSH Server Hardening (Linux)

Disable password auth, lock down SSH to key-only access, change the default port, and restrict user logins. Works on Ubuntu, Debian, Fedora, and openSUSE.

securityTested

Generate an SSH key pair (Linux / macOS / Windows)

Create an Ed25519 SSH key pair and copy the public key to a remote server. Works identically on Linux, macOS, and Windows 10+ with the built-in OpenSSH client.

securityTested

UFW Firewall Baseline (Ubuntu / Debian)

Set up a secure default UFW ruleset: deny all inbound, allow SSH and common homelab services. Safe to run on a fresh VPS or LXC container.

Infrastructure

7 scripts
infrastructureTested

Scratch container lifecycle: create, configure, destroy from code

The full test loop for Proxmox infrastructure code — mint a scoped identity, tofu apply a throwaway container, converge it with Ansible, destroy every trace.

infrastructureTested

Install Proxmox Backup Server + Connect It to PVE

Install PBS 4 from the no-subscription repo, create a datastore, and register it as storage on your Proxmox VE node — ready for deduplicated, scheduled VM and container backups.

infrastructureTested

Build a Proxmox Cloud-Init Template + Clone a VM

One script to turn the Ubuntu 24.04 cloud image into a reusable Proxmox template, plus the three commands that clone and personalize a ready-to-boot VM in seconds.

infrastructureTested

Create a Proxmox VM from the CLI (q35 + OVMF + VirtIO)

The full create-VM wizard as one qm command — q35 machine, OVMF firmware with EFI disk, host CPU, VirtIO SCSI and network, guest agent enabled, ISO attached and ready to install.

infrastructureTested

Install Jellyfin Media Server on Debian/Ubuntu

Install the free, open-source Jellyfin media server on Debian or Ubuntu using the official APT repository, then reach the setup wizard on port 8096.

infrastructureTested

Install Plex Media Server on Debian/Ubuntu

Add Plex's official APT repository, install Plex Media Server, and claim a headless server to your account from the command line.

infrastructureTested

Proxmox VE Post-Install Hardening

Essential post-install steps for a new Proxmox VE 9 node: switch to the free repo (deb822 format), disable the enterprise repo, remove the subscription nag, update the system, and set the basics — with a PVE 8 fallback.

Containers

9 scripts
containersTested

Create a Proxmox LXC Container from the CLI

Download a Debian 12 container template with pveam and create an unprivileged LXC with pct — cores, memory, rootfs, DHCP networking, and nesting enabled, started and updated in one pass.

containersTested

Traefik + Let's Encrypt Reverse Proxy (Docker Compose)

A complete Traefik v3 docker-compose.yml with automatic Let's Encrypt certificates, an HTTPS redirect, and label-based routing — plus the DNS-challenge variant for wildcard certs on internal services.

containersTested

Your First Docker Compose Stack (nginx hello-world)

A starter Docker Compose stack that serves a local folder with nginx. Demonstrates images, containers, ports, volumes, and the five daily-driver compose commands on Linux, macOS, and Windows.

containersTested

Homepage Dashboard — Docker Compose Install

Deploy the Homepage application dashboard with Docker Compose. Creates the config directory, sets the required HOMEPAGE_ALLOWED_HOSTS variable, and starts the container on port 3000.

containersTested

Immich Photo Backup — Docker Compose Install

Deploy Immich v3 with Docker Compose on Linux. Downloads the official compose and env files, sets the upload location and database password, and starts the full stack on port 2283.

containersTested

Uptime Kuma — Docker Compose Install

Deploy Uptime Kuma monitoring on Linux with Docker Compose. Persists data to a named volume and exposes the web UI on port 3001. Covers notification setup and monitor types.

containersTested

Arr Stack Docker Compose (Prowlarr, Radarr, Sonarr + VPN)

A complete docker-compose.yml for the *arr stack — Prowlarr, Radarr, Sonarr, and a VPN-shielded qBittorrent — with the single-root layout that makes imports instant hardlinks.

containersTested

VPN-Shielded Torrent Stack (gluetun + qBittorrent)

Run qBittorrent inside a gluetun VPN container so all torrent traffic exits through a VPN with a kill-switch — plus port-forward sync for full download speed.

containersTested

Install Docker + Docker Compose on Linux

Install Docker Engine and the Compose plugin on Ubuntu, Debian, or Fedora using Docker's official repository. Adds your user to the docker group so sudo isn't required.

Knowledge Base

7 scripts
knowledge-base

A cited RAG endpoint over your Markdown wiki

Retrieve-then-generate Q&A over a local embeddings index in one dependency-free Node file — correct query prefix, in-memory ranking, numbered citations, and every answer stamped with the revision it came from.

knowledge-base

Begin/End skills: a revision-labeled cold start for AI agents

Give AI agents a fail-closed cold start against a Git vault — verify the canonical commit, load the smallest relevant context, and persist outcomes only through the controlled writer.

knowledge-base

Build and query a local embeddings index for a Markdown vault

Section-chunk a Markdown vault, embed with nomic-embed-text on a local Ollama cluster, cache by content hash, swap the index atomically stamped with the vault commit, and query it with fail-closed staleness checks.

knowledge-base

Canonical writer lock + validation gates

Serialize writes to a canonical vault behind a file lock, validate before committing (stdin-fed audit), refresh and verify projections, and abort safely with SIGINT so the lock is always released.

knowledge-base

Generate a topic-map graph from Markdown frontmatter

A Node script that reads topic:/relates: frontmatter across a Markdown vault and generates MOC index pages, region tags, and backlink blocks — with a --check gate that blocks stale commits.

knowledge-base

Stand up a Git + Markdown knowledge vault

Create a bare Git vault on an always-on host and mount it from your laptop over SSHFS, so your editor works on the one canonical copy with no sync step.

knowledge-base

Publish a Markdown vault to Wiki.js with parity (delete-cascade)

Generate a publishable manifest from a Git vault, reconcile Wiki.js to it — create, update, AND delete — then assert exact parity and that the projection reports the source commit.