Files

T

Claude c3bb2cf18c feat(cameras): add sky-cam and frigate-audio service modules

sky-cam (cameras/non-docker):
  Clones outis1one/sky-cam via bootstrap.sh to ~/sky-cam. Prompts for
  latitude, longitude, timezone, camera names, BASE_DIR, and optional
  Mattermost webhook. Patches sky-cam.conf and installs systemd user
  timers via the repo's install.sh. Produces sunrise clips, Four Seasons
  timelapse, moon-track, and monthly moon-phase images.

frigate-audio (cameras/docker):
  Full stack from outis1one/frigate_w_audio: Frigate 0.17 NVR +
  Mosquitto MQTT broker + frigate-notify → ntfy push alerts. Audio-ready
  config template with face recognition and LPR pre-configured. Prompts
  for camera credentials, media storage path (supports drive detection),
  MQTT password (auto-generated), and ntfy server. Bootstraps the
  Mosquitto passwd file. Detector choice: CPU / USB Coral / PCIe Coral.
  Hardcoded media path from upstream replaced with a configurable prompt.

https://claude.ai/code/session_01Y4dMKtkqkpvmgDKoRdzhTG

2026-06-03 21:40:49 +00:00

4.2 KiB

Raw Blame History

Modular Post-Install (`setup.sh` + `lib/` + `services/`)

This is the new structure that gives you one source of truth and the ability to run just the service you want — without maintaining a pile of near-duplicate standalone scripts.

Why

The full ubuntu-post-install-*.sh scripts are great as a "run once, set up the whole box" experience, but to add or update one service you edit a 300 KB file (in two or three places). The separate setup-*.sh scripts are easy to run for one service, but duplicate logic and drift apart.

The fix is not to generate per-service scripts from the monolith (that just triples the maintenance surface). It's to have one implementation per service in a module, shared helpers in a library, and a thin dispatcher with two entry points.

Layout

setup.sh              # dispatcher: menu, run-one, --list, --dry-run, --unattended
lib/common.sh         # shared helpers: logging, prompts, ownership, Caddy wiring,
                      #   the service registry. THE single source of truth.
services/
  base.sh             # essential CLI packages (incl. glow)
  homeassistant.sh    # Home Assistant
  ...                 # one file per service

Usage

sudo ./setup.sh                  # interactive menu (whiptail or text)
sudo ./setup.sh homeassistant    # install one service
sudo ./setup.sh base glow        # install several
./setup.sh --list                # list services, grouped
sudo ./setup.sh --dry-run --unattended minecraft   # preview, no prompts

Anatomy of a service module

Each services/<name>.sh does exactly two things: register itself and define install_.

#!/bin/bash
register_service myapp homelab "What it does" 1234   # name group description [port]

install_myapp() {
    require_docker || return 1
    local DIR="$DOCKER_DIR/myapp"
    [ "$DRY_RUN" = true ] && { echo "[DRY-RUN] Would create $DIR"; return 0; }
    mkdir -p "$DIR"; ensure_docker_dir_ownership "$DIR"; cd "$DIR" || return 1
    cat > docker-compose.yml << 'YAML'
    ...
YAML
    configure_caddy_for_service "MyApp" "1234" "myapp"   # optional reverse proxy
    prompt_yn "Start now? (y/n):" "y" START && docker compose up -d
}

Helpers available from lib/common.sh: log_info/success/warning/error, prompt_yn, prompt_text, run_cmd, ensure_docker_dir_ownership, generate_password, validate_password, configure_caddy_for_service, require_root, require_docker. Globals: DOCKER_DIR, ACTUAL_USER, ACTUAL_HOME, DRY_RUN, UNATTENDED.

Every service installs to its own folder ~/docker/<name>/ with its own docker-compose.yml (the DoTheEvo selfhosted-apps-docker layout) — never a single shared compose file.

Groups

base · homelab · utilities · media · cameras · gaming · extras · backup. extras holds non-Docker add-ons pulled from other repos (e.g. the silent-send browser extension) — things that install/build on the host rather than running as a container, so this script stays a single entry point for them. The guided menu (sudo ./setup.sh) shows the required packages first with a cancel option, then offers Caddy (most services proxy through it), then a category menu you loop through — pick a category, tick services (already installed ones are marked [installed]), install, and you land back on the menu to pick the next category. Within homelab, Caddy → CrowdSec → Authelia are ordered first.

Migration status

Migration is complete. setup.sh + services/ now cover every service from ubuntu-post-install-*-crowdsec.sh plus several extras. The monolith is retained as a frozen evolution record.

Group	Modules
`base`	`base`, `glow`
`homelab`	`caddy`, `crowdsec`, `authelia`, `homeassistant`
`utilities`	`actualbudget`, `ddclient`, `filebrowser`, `fmd`, `magicmirror`, `mealie`, `meshcentral`, `ntfy`, `portainer`, `traccar`, `uptimekuma`, `watchtower`, `wg-easy`
`media`	`arm`, `audiobookshelf`, `emby`, `immich`, `jellyfin`, `lyrion`
`cameras`	`frigate`, `frigate-audio`, `frigate-notify`, `sky-cam`
`gaming`	`js99er`, `minecraft`, `wolf`, `wolf-pair`
`extras`	`linux-to-sync`, `silent-send`, `sync-cc`
`backup`	`backup`

4.2 KiB Raw Blame History

Modular Post-Install (setup.sh + lib/ + services/)

Why