blumeops/docs/how-to/how-to.md
Erich Blume 6f532ca607 Add Authentik deployment plan document
Captures the full deployment plan for replacing Dex with Authentik as the
BlumeOps identity provider, covering Nix containers, kustomize manifests,
cross-cluster CNPG database, networking, and monitoring across 6 phases.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-20 07:05:45 -08:00

2.8 KiB

title modified tags
How-To 2026-02-17
how-to

How-To Guides

Task-oriented instructions for common BlumeOps operations. These guides assume you already understand the basic concepts - see tutorials if you're learning.

Deployment

Guide Description
deploy-k8s-service Deploy a new service to Kubernetes via ArgoCD
add-ansible-role Add a new Ansible role for indri services
create-release-artifact-workflow Build artifacts and publish to Forgejo packages
build-container-image Build and release a custom container image via Dagger

Configuration

Guide Description
update-tailscale-acls Update Tailscale access control policies
gandi-operations Manage DNS records and cycle the Gandi API token
use-pypi-proxy Configure pip and publish packages to devpi
expose-service-publicly Expose a service to the public internet via Fly.io + Tailscale
update-documentation Publish docs via build-blumeops workflow

Knowledge Base

Guide Description
review-documentation Periodically review and maintain documentation
review-services Periodically review services for version freshness

Operations

Guide Description
connect-to-postgres Connect to PostgreSQL as a superuser via psql
restart-indri Safely shut down and restart indri
manage-flyio-proxy Deploy, shutoff, and troubleshoot the public proxy
restore-1password-backup Recover 1Password credentials from borgmatic backup
troubleshooting Diagnose and fix common issues

Plans

Migration and transition plans for upcoming infrastructure changes.

Plan Description
plans Index of all plans
completed Completed plans archive
migrate-forgejo-from-brew Transition Forgejo from Homebrew to source-built binary
add-unifi-pulumi-stack Add Pulumi IaC for UniFi Express 7 (abandoned)
segment-home-network Manual three-network segmentation for UniFi Express 7
adopt-dagger-ci Adopt Dagger as CI/CD build engine
upstream-fork-strategy Stacked-branch forking strategy for upstream projects
adopt-oidc-provider Deploy OIDC identity provider for SSO across services
harden-zot-registry Add authentication and tag immutability to zot registry
forgejo-actions-dashboard Grafana dashboard for Forgejo Actions CI metrics
upgrade-grafana-helm-chart Upgrade Grafana Helm chart from 8.8.2 to 11.x
deploy-authentik Deploy Authentik identity provider to replace Dex
operationalize-reolink-camera Cloud-free NVR with Frigate and ring buffer recording