33 lines
1.1 KiB
Markdown
33 lines
1.1 KiB
Markdown
# 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`)
|
|
|
|
```bash
|
|
# 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`.
|