homeio

1#!/usr/bin/env bash
2# Homeio factory reset
3#
4# Wipes all application state and user data, then reboots the machine into a
5# clean installation. This script is scheduled as a transient systemd unit by
6# power-service.ts and must never be run interactively.
7#
8# Required environment variables (injected via systemd-run --setenv):
9#   DATABASE_URL                PostgreSQL connection string
10#   HOMEIO_RESET_DATA_ROOT      Path to the data root directory  (e.g. /DATA)
11#   HOMEIO_RESET_STACKS_ROOT    Path to the Docker Compose stacks root
12#   HOMEIO_RESET_WORKDIR        Working directory of the Homeio application
13#   HOMEIO_RESET_NPM_BIN        Absolute path to the npm binary
14#
15# Subdirectories recreated under HOMEIO_RESET_DATA_ROOT must stay in sync with
16# DATA_SUBDIRECTORIES in lib/server/storage/data-root.ts.
17
18# -uo pipefail: fail on unbound vars and pipe errors.
19# -e is intentionally omitted: individual step failures are logged but do not
20# abort the reset — the machine must always reach the reboot step.
21set -uo pipefail
22
23FACTORY_RESET_LOG='/var/log/homeio-factory-reset.log'
24
25sleep 2
26
27mkdir -p "$(dirname "${FACTORY_RESET_LOG}")"
28exec >> "${FACTORY_RESET_LOG}" 2>&1
29
30echo "[$(date -Is)] Starting Homeio factory reset"
31
32# ── Validate required env vars ────────────────────────────────────────────────
33: "${DATABASE_URL:?DATABASE_URL is required}"
34: "${HOMEIO_RESET_DATA_ROOT:?HOMEIO_RESET_DATA_ROOT is required}"
35: "${HOMEIO_RESET_STACKS_ROOT:?HOMEIO_RESET_STACKS_ROOT is required}"
36: "${HOMEIO_RESET_WORKDIR:?HOMEIO_RESET_WORKDIR is required}"
37: "${HOMEIO_RESET_NPM_BIN:?HOMEIO_RESET_NPM_BIN is required}"
38
39cd "${HOMEIO_RESET_WORKDIR}"
40export DATABASE_URL
41
42# ── Step 1: Stop the application ──────────────────────────────────────────────
43systemctl stop home-server.service || true
44
45# ── Step 2: Reset the database (before any destructive file ops) ──────────────
46# Running db:reset first ensures the DB is wiped even if the data root is later
47# inaccessible. Failure is logged but does not abort — we keep going.
48echo "[$(date -Is)] Resetting database"
49"${HOMEIO_RESET_NPM_BIN}" run db:reset --silent \
50  && echo "[$(date -Is)] Database reset OK" \
51  || echo "[$(date -Is)] WARNING: database reset failed, continuing"
52
53# ── Step 3: Remove stacks root ────────────────────────────────────────────────
54# STORE_STACKS_ROOT may live outside the data root (e.g. /var/lib/home-server/stacks).
55# Removing it explicitly ensures no orphaned compose files survive the wipe.
56rm -rf "${HOMEIO_RESET_STACKS_ROOT}" || true
57
58# ── Step 4: Docker cleanup ────────────────────────────────────────────────────
59if command -v docker >/dev/null 2>&1; then
60  docker ps -aq | xargs -r docker rm -f                                    || true
61  docker volume ls -q | xargs -r docker volume rm -f                       || true
62  docker network ls --format '{{.Name}}' \
63    | grep -vxE 'bridge|host|none' \
64    | xargs -r docker network rm                                            || true
65  docker images -aq | sort -u | xargs -r docker rmi -f                     || true
66  docker builder prune -af                                                  || true
67  docker system prune -af --volumes                                         || true
68fi
69
70# ── Step 5: Wipe data root ────────────────────────────────────────────────────
71# Use find -mindepth 1 to delete everything inside without removing the root
72# directory itself, so the mount point survives if it is a separate partition.
73if [ -d "${HOMEIO_RESET_DATA_ROOT}" ]; then
74  find "${HOMEIO_RESET_DATA_ROOT}" -mindepth 1 -maxdepth 1 -exec rm -rf {} +
75else
76  mkdir -p "${HOMEIO_RESET_DATA_ROOT}"
77fi
78
79# ── Step 6: Recreate fresh-install directory structure ────────────────────────
80# Mirrors DATA_SUBDIRECTORIES in lib/server/storage/data-root.ts.
81mkdir -p \
82  "${HOMEIO_RESET_DATA_ROOT}/AppData" \
83  "${HOMEIO_RESET_DATA_ROOT}/Documents" \
84  "${HOMEIO_RESET_DATA_ROOT}/Media" \
85  "${HOMEIO_RESET_DATA_ROOT}/Download" \
86  "${HOMEIO_RESET_DATA_ROOT}/.Shared" \
87  "${HOMEIO_RESET_DATA_ROOT}/.Network" \
88  "${HOMEIO_RESET_DATA_ROOT}/.Trash"
89
90echo "[$(date -Is)] Factory reset complete; rebooting"
91
92# ── Step 7: Reboot ────────────────────────────────────────────────────────────
93systemctl reboot
94