Claude
d5941f2b26
Every service from ubuntu-post-install-24.04-crowdsec.sh is now a module. 35 services across 8 categories; setup.sh is the primary install path. - services/linux-to-sync.sh (extras): clone private repo via SSH or PAT - setup.sh: is_installed case for linux-to-sync (~/.git marker) - MODULAR.md: migration table updated to show full inventory - VERSION: 0.9.11 → 1.0.0 (parity achieved) https://claude.ai/code/session_01Y4dMKtkqkpvmgDKoRdzhTG
102 lines
4.2 KiB
Markdown
102 lines
4.2 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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_<name>**.
|
|
|
|
```bash
|
|
#!/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-notify` |
|
|
| `gaming` | `js99er`, `minecraft`, `wolf`, `wolf-pair` |
|
|
| `extras` | `linux-to-sync`, `silent-send` |
|
|
| `backup` | `backup` |
|