Remove deprecated services: Keycloak, Nextcloud, Paperless-ngx, iperf3 #23

Closed
opened 2026-07-25 19:37:12 +00:00 by lab · 1 comment
Owner

Services to remove

  • Keycloak (k3s-ha-cluster/keycloak/) — Authelia is the primary auth layer. Keycloak adds overhead (separate PostgreSQL, Java heap) for a secondary system.
  • Nextcloud (k3s-ha-cluster/nextcloud/) — marked deprecated in README, Caddy route already commented out
  • Paperless-ngx (k3s-ha-cluster/paperless-ngx/) — marked deprecated, has placeholder credentials
  • iperf3 (k3s-ha-cluster/iperf3/) — replaced by speedtest-tracker

Steps

  1. helm uninstall keycloak -n keycloak && kubectl delete namespace keycloak
  2. kubectl delete namespace nextcloud
  3. kubectl delete namespace paperless
  4. kubectl delete -f k3s-ha-cluster/iperf3/ and remove namespace
  5. Remove directories: keycloak/, nextcloud/, paperless-ngx/, iperf3/
  6. Update README.md to remove deprecated sections
  7. Remove Keycloak-related Caddy routes if any remain
  8. Close milestone #3 (Keycloak Setup) after Keycloak removal
## Services to remove - **Keycloak** (`k3s-ha-cluster/keycloak/`) — Authelia is the primary auth layer. Keycloak adds overhead (separate PostgreSQL, Java heap) for a secondary system. - **Nextcloud** (`k3s-ha-cluster/nextcloud/`) — marked deprecated in README, Caddy route already commented out - **Paperless-ngx** (`k3s-ha-cluster/paperless-ngx/`) — marked deprecated, has placeholder credentials - **iperf3** (`k3s-ha-cluster/iperf3/`) — replaced by speedtest-tracker ## Steps 1. `helm uninstall keycloak -n keycloak && kubectl delete namespace keycloak` 2. `kubectl delete namespace nextcloud` 3. `kubectl delete namespace paperless` 4. `kubectl delete -f k3s-ha-cluster/iperf3/` and remove namespace 5. Remove directories: `keycloak/`, `nextcloud/`, `paperless-ngx/`, `iperf3/` 6. Update README.md to remove deprecated sections 7. Remove Keycloak-related Caddy routes if any remain 8. Close milestone #3 (Keycloak Setup) after Keycloak removal
lab added this to the Cleanup & Hygiene milestone 2026-07-25 19:37:12 +00:00
Author
Owner

Done. Commit see push on master.

Removed from cluster

  • keycloak, nextcloud, paperless namespaces and all workloads (helm
    releases + raw manifests); iperf3 daemonset removed
  • Caddy routes, ddns subdomain entries, Homer tiles, monitoring references

Removed from repo

  • k3s-ha-cluster/{keycloak,nextcloud,paperless-ngx,iperf3}/
  • README sections rewritten (Keycloak/Nextcloud/Paperless docs deleted;
    Forgejo SSO docs corrected to Authelia OIDC)

Data note (important)

Nextcloud (10Gi) and Paperless-ngx (3Gi) Longhorn volumes were removed along
with their PVCs. No Longhorn backup target is configured (#32 still open),
so this data could not be restored. Both services were deprecated and had been
idle; if anything of value lived there, it is not recoverable from the cluster.

Follow-up

This is exactly the gap #32 (backup strategy) exists for — worth prioritizing
before any future removals.

Done. Commit `see push on master`. ## Removed from cluster - `keycloak`, `nextcloud`, `paperless` namespaces and all workloads (helm releases + raw manifests); iperf3 daemonset removed - Caddy routes, ddns subdomain entries, Homer tiles, monitoring references ## Removed from repo - `k3s-ha-cluster/{keycloak,nextcloud,paperless-ngx,iperf3}/` - README sections rewritten (Keycloak/Nextcloud/Paperless docs deleted; Forgejo SSO docs corrected to Authelia OIDC) ## Data note (important) Nextcloud (10Gi) and Paperless-ngx (3Gi) Longhorn volumes were removed along with their PVCs. **No Longhorn backup target is configured** (#32 still open), so this data could not be restored. Both services were deprecated and had been idle; if anything of value lived there, it is not recoverable from the cluster. ## Follow-up This is exactly the gap #32 (backup strategy) exists for — worth prioritizing before any future removals.
lab closed this issue 2026-08-22 20:29:44 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
lab/homelab#23
No description provided.