#!/usr/bin/env bash # Live in-lecture quiz portal — VPS bootstrap. # Idempotent: safe to re-run on a partially-bootstrapped host. # Designed for: fresh Ubuntu 24.04 LTS, run as root. # # Usage (one-shot, on the VPS): # curl -fsSL https://gitea.ahkhan.me/apps/quiz/raw/branch/master/deploy/bootstrap.sh | bash # # Override via env: # DOMAIN=quiz.example.org curl ... | bash # REPO_URL=https://... curl ... | bash set -euo pipefail REPO_URL="${REPO_URL:-https://gitea.ahkhan.me/apps/quiz.git}" APP_DIR="${APP_DIR:-/opt/quiz}" APP_USER="${APP_USER:-quiz}" DOMAIN="${DOMAIN:-quiz.ahkhan.me}" BRANCH="${BRANCH:-master}" if [ "$(id -u)" != "0" ]; then echo "bootstrap.sh must run as root" >&2 exit 1 fi stage() { printf '\n==> Stage %s\n' "$*"; } stage "1/9: apt update + base packages" apt-get update -q DEBIAN_FRONTEND=noninteractive apt-get install -y -q \ git curl ca-certificates gnupg \ python3 python3-venv python3-pip \ debian-keyring debian-archive-keyring apt-transport-https stage "2/9: install Caddy (skip if present)" if ! command -v caddy >/dev/null 2>&1; then curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' \ | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' \ | tee /etc/apt/sources.list.d/caddy-stable.list >/dev/null apt-get update -q apt-get install -y -q caddy fi stage "3/9: create $APP_USER system user (skip if present)" if ! id "$APP_USER" >/dev/null 2>&1; then useradd --system --shell /usr/sbin/nologin --home-dir "$APP_DIR" "$APP_USER" fi stage "4/9: clone or update repo into $APP_DIR" if [ -d "$APP_DIR/.git" ]; then git -C "$APP_DIR" fetch origin git -C "$APP_DIR" reset --hard "origin/$BRANCH" else rm -rf "$APP_DIR" git clone --branch "$BRANCH" "$REPO_URL" "$APP_DIR" fi chown -R "$APP_USER":"$APP_USER" "$APP_DIR" stage "5/9: build venv + install dependencies" sudo -u "$APP_USER" -H python3 -m venv "$APP_DIR/.venv" sudo -u "$APP_USER" -H "$APP_DIR/.venv/bin/pip" install --quiet --upgrade pip sudo -u "$APP_USER" -H "$APP_DIR/.venv/bin/pip" install --quiet -e "$APP_DIR" stage "6/9: configure environment (.env)" ENV_FILE="$APP_DIR/.env" if [ ! -f "$ENV_FILE" ]; then if [ -f /root/.quiz.env ]; then echo "Using /root/.quiz.env" cp /root/.quiz.env "$ENV_FILE" else # Need to prompt for the admin password; reattach TTY if curl|bash # left stdin pointed at the pipe. if [ ! -t 0 ] && [ -r /dev/tty ]; then exec < /dev/tty fi if [ ! -t 0 ]; then echo "ERROR: stdin is not a TTY and /root/.quiz.env is missing." >&2 echo "Either pre-populate /root/.quiz.env or run this script interactively." >&2 exit 1 fi QUIZ_SECRET_KEY=$(python3 -c 'import secrets; print(secrets.token_urlsafe(48))') printf 'Admin password (input hidden): ' read -rs QUIZ_ADMIN_PASSWORD echo cat > "$ENV_FILE" < /etc/caddy/Caddyfile systemctl reload caddy echo echo "==> Health check" sleep 2 if curl -fs http://127.0.0.1:8001/healthz; then echo echo echo "Bootstrap complete. Public URL: https://$DOMAIN" else echo echo "Health check failed. Inspect: journalctl -u quiz.service -n 50" exit 1 fi