koopa-admin-log/scripts/castopod

Castopod ops scripts (koopa)

Live stack: /home/hernani/koopa-castopod/ (podman-compose).
These scripts live in admin-log and should be copied to the host when changed.

Usage (on koopa as hernani)

# copy once
mkdir -p ~/koopa-castopod/bin
cp /path/to/koopa-admin-log/scripts/castopod/{lib.sh,status.sh,up.sh,install-systemd.sh,apply-branding.sh} \
  ~/koopa-castopod/bin/
chmod +x ~/koopa-castopod/bin/*.sh

~/koopa-castopod/bin/status.sh
~/koopa-castopod/bin/up.sh
~/koopa-castopod/bin/install-systemd.sh   # boot units
~/koopa-castopod/bin/apply-branding.sh    # logo + theme + optional overlay

Env overrides: CP_MAX_TIME, CP_PULL_TIMEOUT, CP_HEALTH_TRIES, CP_BASEURL,
CP_SITE_NAME, CP_SITE_DESCRIPTION, CP_THEME (default amber), CP_APPLY_OVERLAY (default 1).

Passwords stay in ~/koopa-castopod/.env and users.env (mode 600) — never in admin-log.

Official branding docs

Instance settings (name, description, site icon, six accent themes):

https://docs.castopod.org/main/en/user-guide/instance/settings/

See also configs/castopod/README.md and 2026/2026-07-13--castopod-boot-branding.md.