Finishes the installApp refactor started in d941f59 (Wave A). Every app
whose <app>.sh was either pure boilerplate (Wave B) or boilerplate +
small custom logic (Wave C) now routes through the generic driver in
scripts/app/install/app_install.sh; bespoke logic moved to declarative
hooks in containers/<app>/scripts/<app>_install_hooks.sh.
Net: ~4,000 lines of duplicated 10-step sequence gone. From 31 per-app
.sh files (pre-Wave-A) down to 2 intentional keepers.
DELETED outright (pure boilerplate — driver replaces them identically):
jellyfin, mastodon, focalboard, ipinfo, speedtest, dashy, invidious,
nextcloud, ollama, vaultwarden, pihole
DELETED + hook-extracted (small bespoke step preserved in a hook):
bookstack, moneyapp, owncloud, trilium, searxng, gitea, headscale,
unbound, prometheus, grafana, gluetun, wireguard, jitsimeet, authelia,
traefik, adguard, onlyoffice
KEPT (intentional special cases):
crowdsec — host-app pattern (no docker compose, runs as apt+
systemd via installCrowdsecHost; uninstall/stop/
restart hooks already live in this file and are
invoked by dockerUninstall/Stop/RestartApp directly).
libreportal — WebUI bootstrap. Pre-compose image build + post-install
webuiLibrePortalUpdate + bootstrap-time suppression of
menuShowFinalMessages don't fit the generic flow.
Driver change — scripts/app/install/app_install.sh:
Moved monitoringToggleAppConfig "$app_name" "docker-compose.yml" from
the post-start integrations block into the install body at post-compose
(right after dockerComposeSetupFile, before docker-compose up). The
toggle edits the compose file on disk — running it after start meant
the container had already been brought up with the unmodified compose,
so the metrics endpoint wouldn't reflect CFG_<APP>_MONITORING until
the next restart. Matches the original ordering in every per-app .sh
that used to call it inline.
Hook surface (declare-f-gated, silent no-op when absent):
<slug>_install_pre before any install work
<slug>_install_post_setup after dockerConfigSetupToContainer
<slug>_install_post_compose after dockerComposeSetupFile (+ the
shared monitoring toggle on the compose)
<slug>_install_post_start after dockerComposeUpdateAndStartApp
<slug>_install_message_data echoes extra argv for menuShowFinalMessages
<slug>_install_post very last thing, after the final message
+ the existing _uninstall_pre/_post, _stop_post, _restart_post
Notable extractions:
bookstack — _install_post_start: probe :PORT_1/login until 200/302,
then `bookstack:create-admin` inside the container with
CFG_BOOKSTACK_ADMIN_{EMAIL,PASSWORD}; falls back to the
seeded admin@admin.com on timeout.
adguard — _install_post_start drives the wizard's HTTP API
(POST /control/install/configure) so the admin doesn't
click through five pages, then pins the admin bind back
to 0.0.0.0:3000 (matches the compose mapping) and health
checks. _install_message_data echoes user/password to
menuShowFinalMessages.
authelia — _install_pre requirements; _install_post_compose copies
configuration.yml + users_database.yml, substitutes
theme/domain/host, generates JWT/session/storage secrets,
toggles monitoring on configuration.yml; _install_post_start
argon2-hashes the admin password via the container, writes
users_database.yml, restarts; _install_post echoes creds.
traefik — _install_pre prompts for the LE email if CFG_TRAEFIK_EMAIL
is unset; _install_post_compose copies static + dynamic
configs, wires CFG_TRAEFIK_DASHBOARD_ACCESS (local-only /
domain-only / public), toggles monitoring on traefik.yml,
then traefikUpdateWhitelist + traefikSetupLoginCredentials.
wireguard — _install_pre host-conflict guard (/etc/wireguard/params);
_install_post_compose persists CFG_WIREGUARD_SUBNET,
resolves WG_HOST (domain+traefik → host_setup, else IP),
runs runAppCfg wireguard-ip-forward; _install_post_start
restarts after wg-easy installs its iptables rules.
jitsimeet — _install_post_setup downloads the tagged release zip from
GitHub; _install_post_compose mass-edits the .env and runs
gen-passwords.sh; _install_post_start rewrites nginx
default site to usedport1/2 + restart.
prometheus — _install_post_compose seeds prometheus.yml under
$containers_dir/prometheus/prometheus/; _install_post_start
sets 0777 on storage dirs so the container TSDB can write
regardless of host UID mapping.
grafana — _install_pre requirements; _install_post_start 0777 on
grafana_storage.
gluetun — _install_post_start refreshes the provider snapshot,
reattaches every routed app (the netns container ID is
stale after gluetun gets recreated), then prompts to
onboard any existing apps.
+ the smaller bookstack-shape extractions for owncloud (version scrape),
trilium / searxng (wait-for-first-boot-config), gitea (Prometheus
bearer token sync), headscale / unbound (config copy), moneyapp
(Auth.js AUTH_URL), onlyoffice (compose-resolved user/pass into the
final message).
Manifest + arrays regenerated. Verified end-to-end:
- bash -n on every hook file + the driver: clean
- Each hook file sources cleanly in a subshell, exposes only the
intended functions, flagged lazy-loadable (not eager)
- Smoke-stubbed install run for jellyfin (pure), nextcloud (pure),
bookstack (hooked), crowdsec (kept): correct dispatch in all cases —
deleted apps route to installApp, kept apps still hit their real
function
Signed-off-by: librelad <librelad@digitalangels.vip>
104 lines
3.8 KiB
Bash
104 lines
3.8 KiB
Bash
#!/bin/bash
|
|
|
|
# WireGuard install hooks — host-conflict guard, tunnel subnet generation,
|
|
# WG_HOST resolution, IP forwarding setup, and a post-start restart so
|
|
# the firewall rules from wg-easy take effect cleanly.
|
|
|
|
wireguard_install_pre()
|
|
{
|
|
local app_name="$1"
|
|
|
|
((menu_number++))
|
|
echo ""
|
|
echo "---- $menu_number. Checking if $app_name can be installed."
|
|
echo ""
|
|
|
|
# Host-conflict guard: a host-level WireGuard (e.g. the angristan
|
|
# wireguard-install script — marker /etc/wireguard/params) collides
|
|
# with this container on the wg kernel module + UDP 51820. Abort.
|
|
if [[ -e /etc/wireguard/params ]]; then
|
|
isError "WireGuard is already installed on the host — this conflicts with the $app_name app."
|
|
isError "Installation is now aborting..."
|
|
dockerUninstallApp "$app_name"
|
|
return 1
|
|
fi
|
|
}
|
|
|
|
wireguard_install_post_compose()
|
|
{
|
|
local app_name="$1"
|
|
|
|
((menu_number++))
|
|
echo ""
|
|
echo "---- $menu_number. Resolving wireguard tunnel subnet (WG_DEFAULT_ADDRESS)"
|
|
echo ""
|
|
|
|
# Generate-once-and-persist tunnel subnet. Second-octet 200-250 is
|
|
# outside the docker network generator range (100-149), so the two
|
|
# subnets cannot collide. Reusing the persisted value keeps existing
|
|
# peer configs valid across reinstalls.
|
|
local _wg_compose_for_subnet="$containers_dir$app_name/docker-compose.yml"
|
|
if [[ -z "$CFG_WIREGUARD_SUBNET" ]]; then
|
|
local _wg_second=$(( RANDOM % 51 + 200 ))
|
|
local _wg_third=$(( RANDOM % 256 ))
|
|
CFG_WIREGUARD_SUBNET="10.${_wg_second}.${_wg_third}.0"
|
|
updateConfigOption "CFG_WIREGUARD_SUBNET" "$CFG_WIREGUARD_SUBNET"
|
|
isSuccessful "Generated wireguard tunnel subnet: $CFG_WIREGUARD_SUBNET"
|
|
else
|
|
isNotice "Reusing existing wireguard tunnel subnet: $CFG_WIREGUARD_SUBNET"
|
|
fi
|
|
# wg-easy expects the address pattern `<base>.x` (literal x).
|
|
local _wg_addr_pattern="${CFG_WIREGUARD_SUBNET%.0}.x"
|
|
tagsManagerUpdateUniversalTag "$_wg_compose_for_subnet" "WIREGUARD_SUBNET_TAG" "$_wg_addr_pattern"
|
|
isSuccessful "WG_DEFAULT_ADDRESS set to $_wg_addr_pattern"
|
|
|
|
((menu_number++))
|
|
echo ""
|
|
echo "---- $menu_number. Resolving WG_HOST for peer configs"
|
|
echo ""
|
|
|
|
local wg_compose_file="$containers_dir$app_name/docker-compose.yml"
|
|
local wg_host_value=""
|
|
local _wg_traefik_installed=0
|
|
if declare -f checkServiceInstalled >/dev/null 2>&1 && checkServiceInstalled "traefik"; then
|
|
_wg_traefik_installed=1
|
|
fi
|
|
if [[ -n "$domain_full" && $_wg_traefik_installed -eq 1 ]]; then
|
|
wg_host_value="$host_setup"
|
|
isNotice "Domain + Traefik present — peer configs will use $wg_host_value"
|
|
else
|
|
wg_host_value="${public_ip_v4:-127.0.0.1}"
|
|
if [[ -n "$domain_full" && $_wg_traefik_installed -eq 0 ]]; then
|
|
isNotice "Domain configured but Traefik not installed — falling back to IP $wg_host_value so peer configs actually resolve."
|
|
else
|
|
isNotice "No domain configured — peer configs will use IP $wg_host_value (LAN only)"
|
|
fi
|
|
fi
|
|
tagsManagerUpdateUniversalTag "$wg_compose_file" "PUBLIC_IP_TAG" "$wg_host_value"
|
|
isSuccessful "WG_HOST set to $wg_host_value"
|
|
|
|
((menu_number++))
|
|
echo ""
|
|
echo "---- $menu_number. Enabling IP forwarding"
|
|
echo ""
|
|
|
|
# Drop in /etc/sysctl.d/99-libreportal-wireguard.conf + reload — the
|
|
# whole thing runs as root through libreportal-appcfg so the manager
|
|
# never needs blanket /etc write or `sudo sysctl` itself.
|
|
local result
|
|
result=$(runAppCfg wireguard-ip-forward)
|
|
checkSuccess "Enabling IPv4 IP Forwarding (sysctl drop-in + reload)"
|
|
}
|
|
|
|
wireguard_install_post_start()
|
|
{
|
|
local app_name="$1"
|
|
|
|
((menu_number++))
|
|
echo ""
|
|
echo "---- $menu_number. Restarting $app_name after firewall changes"
|
|
echo ""
|
|
|
|
dockerComposeRestart $app_name
|
|
}
|