#!/usr/bin/env bash # infra/authentik/backup/backup.sh # # Daily backup of the self-hosted Authentik stack. Triggered by crond at 03:30 # UTC (see crontab). Idempotent — re-running on the same day overwrites the # same S3 prefix. # # Steps: # 1. pg_dump --format=custom of the Authentik Postgres # 2. tar of /media (Authentik media volume, mounted into this container) # 3. SECRETS-MANIFEST.txt listing the env-var names that MUST be backed up # out-of-band (Coolify-Vault export) # 4. GPG-encrypt all three artifacts to a dedicated backup recipient # 5. Upload to S3 under s3:///authentik/YYYY-MM-DD/ # # Env (sourced from the Compose service `environment` block, which itself # reads from infra/authentik/.env): # AUTHENTIK_S3_BACKUP_ENDPOINT S3 endpoint URL # AUTHENTIK_S3_BACKUP_BUCKET target bucket name # AUTHENTIK_S3_BACKUP_ACCESS_KEY S3 access key # AUTHENTIK_S3_BACKUP_SECRET_KEY S3 secret key # AUTHENTIK_BACKUP_GPG_RECIPIENT required dedicated GPG recipient fingerprint # # AUTHENTIK_PG_HOST default "postgresql" (compose service name) # AUTHENTIK_PG_PORT default 5432 # AUTHENTIK_POSTGRESQL__USER default "authentik" # AUTHENTIK_POSTGRESQL__NAME default "authentik" # AUTHENTIK_POSTGRESQL__PASSWORD required (read via PGPASSWORD env) set -Eeuo pipefail shopt -s inherit_errexit 2>/dev/null || true # ----------------------------------------------------------------------------- # Defaults + required-env guard # ----------------------------------------------------------------------------- : "${AUTHENTIK_PG_HOST:=postgresql}" : "${AUTHENTIK_PG_PORT:=5432}" : "${AUTHENTIK_POSTGRESQL__USER:=authentik}" : "${AUTHENTIK_POSTGRESQL__NAME:=authentik}" : "${AUTHENTIK_S3_BACKUP_ENDPOINT:?AUTHENTIK_S3_BACKUP_ENDPOINT is required}" : "${AUTHENTIK_S3_BACKUP_BUCKET:?AUTHENTIK_S3_BACKUP_BUCKET is required}" : "${AUTHENTIK_S3_BACKUP_ACCESS_KEY:?AUTHENTIK_S3_BACKUP_ACCESS_KEY is required}" : "${AUTHENTIK_S3_BACKUP_SECRET_KEY:?AUTHENTIK_S3_BACKUP_SECRET_KEY is required}" : "${AUTHENTIK_POSTGRESQL__PASSWORD:?AUTHENTIK_POSTGRESQL__PASSWORD is required}" : "${AUTHENTIK_BACKUP_GPG_RECIPIENT:?AUTHENTIK_BACKUP_GPG_RECIPIENT is required}" TODAY="$(date -u +%Y-%m-%d)" NOW="$(date -u +%Y-%m-%dT%H-%M-%SZ)" WORK="${BACKUP_HOME:-/srv/backup}/work/${TODAY}" mkdir -p "${WORK}" log() { printf "[authentik-backup %s] %s\n" "${NOW}" "$*"; } cleanup() { rm -rf "${WORK}"; } trap cleanup EXIT # ----------------------------------------------------------------------------- # Step 1: Postgres dump # ----------------------------------------------------------------------------- log "dumping Postgres (${AUTHENTIK_PG_HOST}/${AUTHENTIK_POSTGRESQL__NAME})" PG_DUMP_FILE="${WORK}/authentik-postgres-${NOW}.dump" export PGPASSWORD="${AUTHENTIK_POSTGRESQL__PASSWORD}" pg_dump \ --host "${AUTHENTIK_PG_HOST}" \ --port "${AUTHENTIK_PG_PORT}" \ --username "${AUTHENTIK_POSTGRESQL__USER}" \ --dbname "${AUTHENTIK_POSTGRESQL__NAME}" \ --format=custom \ --compress=9 \ --no-owner \ --no-privileges \ --file "${PG_DUMP_FILE}" log "postgres dump size: $(du -h "${PG_DUMP_FILE}" | cut -f1)" # ----------------------------------------------------------------------------- # Step 2: media volume tar # ----------------------------------------------------------------------------- MEDIA_TAR="${WORK}/authentik-media-${NOW}.tar.gz" if [[ -d /media ]]; then log "archiving /media" tar -czf "${MEDIA_TAR}" -C / media || log "media tar exited non-zero (continuing)" log "media archive size: $(du -h "${MEDIA_TAR}" | cut -f1)" else log "/media not mounted in backup container — skipping media tar" MEDIA_TAR="" fi # ----------------------------------------------------------------------------- # Step 3: SECRETS-MANIFEST.txt # ----------------------------------------------------------------------------- # CRITICAL: without these secrets the Postgres dump is useless — Authentik # encrypts OIDC provider client_secrets, password-stage data, etc. with # AUTHENTIK_SECRET_KEY. Restoring a dump against a fresh instance with a # DIFFERENT key will leave you with unreadable encrypted fields. SECRETS_MANIFEST="${WORK}/SECRETS-MANIFEST-${NOW}.txt" cat > "${SECRETS_MANIFEST}" <