Mint System Nextcloud

This Helm chart deploys Nextcloud with PostgreSQL.

This chart is a wrapper for the official Nextcloud chart: https://github.com/nextcloud/helm/blob/main/charts/nextcloud/README.md#configuration

Secrets

Setup a nextcloud-creds secret with any additional environment variables you want to pass to Nextcloud.

kubectl create secret generic nextcloud-creds \
    --from-literal=nextcloud-username="$nextcloud_admin_user" \
    --from-literal=nextcloud-password="$nextcloud_admin_password" \
    --from-literal=smtp-host="$smtp_host" \
    --from-literal=smtp-username="$smtp_username" \
    --from-literal=smtp-password="$smtp_password" \
    -n $namespace

The K8up backup requires a s3-credentials and a backup-repo secret. Here is an example for Exoscale SOS:

kubectl create secret generic s3-credentials \
    --from-literal=username="$exoscale_iam_key" \
    --from-literal=password="$exoscale_iam_secret" \
    -n $namespace

Parameters

Ingress parameters

Name	Description	Value
ingress.enabled	Enable or disable the ingress	true
ingress.className	The class name for the ingress	""
ingress.clusterIssuerRef	The cluster issuer reference for the ingress	nil
ingress.host	The host for the ingress	""

Nextcloud parameters

Name	Description	Value
nextcloud.enabled	Enable or disable Nextcloud	true
nextcloud.ingress.enabled	Enable or disable the Nextcloud subchart ingress	false
nextcloud.nextcloud.host	The host for Nextcloud and Ingress	""
nextcloud.nextcloud.existingSecret.enabled	Use an existing secret for credentials	true
nextcloud.nextcloud.existingSecret.enabled	Enable or disable using an existing secret	true
nextcloud.nextcloud.existingSecret.secretName	Name of the existing Kubernetes secret	nextcloud-creds
nextcloud.nextcloud.mail.enabled	Whether to enable/disable email settings	true
nextcloud.persistence.enabled	Enable persistence using PVC	true
nextcloud.phpClientHttpsFix.enabled	Fix HTTPS protocol detection behind reverse proxy	true
nextcloud.internalDatabase.enabled	Enable or disable the internal SQLite database	false
nextcloud.redis.enabled	Enable or disable the bitnami Redis subchart	false
nextcloud.redis.auth.enabled	Enable or disable Redis authentication	false
nextcloud.externalRedis.enabled	Enable or disable external Redis	true
nextcloud.externalRedis.host	Hostname or service name of the external Redis	nextcloud-redis
nextcloud.externalDatabase.enabled	Enable or disable external database usage	true
nextcloud.externalDatabase.type	Type of external database (e.g., postgresql, mysql)	postgresql
nextcloud.externalDatabase.host	Hostname or service name of the external database	nextcloud-postgresql-rw
nextcloud.externalDatabase.database	Name of the database to use	nextcloud
nextcloud.externalDatabase.existingSecret.enabled	Enable or disable using an existing secret for database credentials	true
nextcloud.externalDatabase.existingSecret.secretName	Name of the existing Kubernetes secret	nextcloud-postgresql-app
nextcloud.externalDatabase.existingSecret.usernameKey	Key in the secret containing the database username	username
nextcloud.externalDatabase.existingSecret.passwordKey	Key in the secret containing the database password	password

Redis parameters

Name	Description	Value
redis.enabled	Enable or disable Redis	true
redis.image	The image for Redis	redis:alpine

CloudNativePG parameters

Name	Description	Value
cnpg.enabled	Enable or disable CloudNativePG	true
cnpg.instances	Number of instances (1 for single, 2+ for high availability)	1
cnpg.imageName	PostgreSQL image to use	ghcr.io/cloudnative-pg/postgresql:16.0
cnpg.storage.size	Persistent volume size for each instance	8Gi
cnpg.database	Name of the CloudNativePG database to create	nextcloud
cnpg.owner	Name of the database user	app

K8up parameters

Name	Description	Value
k8up.enabled	Enable or disable K8up	false
k8up.endpoint	S3 endpoint	""
k8up.bucket	S3 bucket name	""

Troubleshooting

The config.php is not updated

Problem

The config.php of Nextcloud is not updated with new env values.

Solution

Delete the config.php file and the pods.

kubectl exec <pod> -- rm /var/www/html/config/config.php
kubectl delete pod <pod>