How to Update Nextcloud Version

Guide for updating Nextcloud and related component versions.

Before You Begin

Update Process

1. Update config.yaml

versions:
  nextcloud: "31.0.14"  # Update version

2. Regenerate Manifests

cd dp-kup/internal/nextcloud/nextcloud{instance}
npm run synth

3. Review Changes

git diff manifests/

4. Commit and Push

git add config.yaml manifests/
git commit -m "update: Nextcloud to 31.0.14"
git push

5. Monitor Deployment

ArgoCD auto-syncs changes:

kubectl get application -n argocd nextcloud-nextcloud{instance} -w
kubectl get pods -n nextcloud{instance} -w

6. Run Upgrade

kubectl exec -n nextcloud{instance} deploy/nextcloud -- php occ upgrade

7. Verify

kubectl exec -n nextcloud{instance} deploy/nextcloud -- php occ status

Updating Other Components

PostgreSQL

CNPG handles PostgreSQL upgrades. Update major version carefully.

Collabora

versions:
  collabora: "25.04.9.1"

Redis

versions:
  redis: "7.4.1"

Rollback

If upgrade fails:

# Revert git commit
git revert HEAD
git push

# ArgoCD syncs old version
# Database should auto-recover via CNPG