This repository has been archived on 2026-08-17. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
debian-configuration/README.md
T
beatzaplentyandClaude Sonnet 4.6 89cc8c8cc3 feat(freeipa): add domain-controller setup — Rocky Linux 9 + FreeIPA 4.13
Installs and documents the FreeIPA identity management server at
domain-controller.sweet.home (VMID 108, pve1). Provides Kerberos,
LDAP, and integrated DNS for the SWEET.HOME realm.

New section: freeipa/
- docs/install.md: full step-by-step reproduction procedure including
  Proxmox VM prep (Rocky Linux 9 GenericCloud, SeaBIOS, cloud-init),
  swap setup, static IP, /etc/hosts fix, ipa-server-install flags
- docs/pihole-dns.md: how to configure Pi-hole to forward sweet.home
  queries to the FreeIPA BIND instance
- scripts/install.sh: idempotent install script with pre-flight checks;
  reads passwords from env or interactive prompt (never commits them)
- scripts/configure-pihole-dns.sh: idempotent Pi-hole forwarder setup
- scripts/verify.sh: read-only health check (13 checks, 0 side effects)
- CLAUDE.md: host guardrails for domain-controller

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015Jbvxx4xbHVcx1NkK3vtmK
2026-07-27 07:22:05 +10:00

1.7 KiB

debian-configuration

Configuration, hardening toolsets, and operational docs for Wayne's Debian-based LAN machines. Each subdirectory covers a different host or service type.

Layout

proxmox/   Proxmox VE hosts (pve1 production, pve-test sandbox)
pihole/    Pi-hole DNS/DHCP (config snapshots, pull/apply scripts)
freeipa/   FreeIPA identity management server (domain-controller.sweet.home)
scripts/   Repo-wide scripts (secret scanning, git hook installer)

Sections

proxmox/

Base configuration and hardening toolset for Proxmox VE hosts. See proxmox/README.md for goals, quick-start, and current status.

pihole/

Pi-hole v6 configuration management. Stores a sanitised snapshot of the live config and provides scripts to pull from or push to a running instance. See pihole/README.md for usage.

freeipa/

FreeIPA 4.x identity management server running on Rocky Linux 9 (domain-controller.sweet.home, VMID 108 on pve1). Provides Kerberos, LDAP, and integrated DNS for the sweet.home realm. See freeipa/README.md for the quick-start and freeipa/docs/install.md for the full reproduction procedure.

Secret scanning

All commits are scanned for secrets by a CI pipeline that runs on both GitHub Actions and Gitea Actions. The same scan can be run locally:

# One-time setup — installs a pre-commit git hook
bash scripts/install-hooks.sh

# Manual run against the full git history
bash scripts/check-secrets.sh

# Requires gitleaks on PATH; falls back to Docker if available
# https://github.com/gitleaks/gitleaks#installing

pihole/pull-config.sh automatically redacts sensitive fields (pwhash, totp_secret, app_pwhash) from pihole.toml before writing it to disk, so the repo stays clean by default.