nextcloud

nextcloud is a file sharing server that puts the control and security of your own data back into your hands.

TL;DR;

$ helm install stable/nextcloud

Introduction

This chart bootstraps an nextcloud deployment on a Kubernetes cluster using the Helm package manager.

It also packages the Bitnami MariaDB chart which is required for bootstrapping a MariaDB deployment for the database requirements of the nextcloud application.

Prerequisites

• Kubernetes 1.9+ with Beta APIs enabled
• PV provisioner support in the underlying infrastructure

Installing the Chart

To install the chart with the release name my-release:

$ helm install --name my-release stable/nextcloud

The command deploys nextcloud on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.

Tip: List all releases using helm list

Uninstalling the Chart

To uninstall/delete the my-release deployment:

$ helm delete my-release

The command removes all the Kubernetes components associated with the chart and deletes the release.

Configuration

The following table lists the configurable parameters of the nextcloud chart and their default values.

Parameter	Description	Default
image.repository	nextcloud Image name	nextcloud
image.tag	nextcloud Image tag	{VERSION}
image.pullPolicy	Image pull policy	Always if imageTag is latest, else IfNotPresent
image.pullSecrets	Specify image pull secrets	nil
ingress.enabled	Enable use of ingress controllers	false
ingress.servicePort	Ingress' backend servicePort	http
ingress.annotations	An array of service annotations	nil
ingress.labels	An array of service labels	nil
ingress.tls	Ingress TLS configuration	[]
nextcloud.host	nextcloud host to create application URLs	nextcloud.kube.home
nextcloud.username	User of the application	admin
nextcloud.password	Application password	changeme
nextcloud.update	Trigger update if custom command is used	0
nextcloud.datadir	nextcloud data dir location	/var/www/html/data
nextcloud.tableprefix	nextcloud db table prefix	''
nextcloud.mail.enabled	Whether to enable/disable email settings	false
nextcloud.mail.fromAddress	nextcloud mail send from field	nil
nextcloud.mail.domain	nextcloud mail domain	nil
nextcloud.mail.smtp.host	SMTP hostname	nil
nextcloud.mail.smtp.secure	SMTP connection ssl or empty	''
nextcloud.mail.smtp.port	Optional SMTP port	nil
nextcloud.mail.smtp.authtype	SMTP authentication method	LOGIN
nextcloud.mail.smtp.name	SMTP username	''
nextcloud.mail.smtp.password	SMTP password	''
nextcloud.configs	Config files created in /var/www/html/config	{}
nextcloud.phpConfigs	PHP Config files created in /usr/local/etc/php/conf.d	{}
nextcloud.defaultConfigs.\.htaccess	Default .htaccess to protect /var/www/html/config	true
nextcloud.defaultConfigs.\.redis\.config\.php	Default Redis configuration	true
nextcloud.defaultConfigs.\.apache-pretty-urls\.config\.php	Default Apache configuration for rewrite urls	true
nextcloud.defaultConfigs.\.apcu\.config\.php	Default configuration to define APCu as local cache	true
nextcloud.defaultConfigs.\.apps\.config\.php	Default configuration for apps	true
nextcloud.defaultConfigs.\.autoconfig\.php	Default auto-configuration for databases	true
nextcloud.defaultConfigs.\.smtp\.config\.php	Default configuration for smtp	true
internalDatabase.enabled	Whether to use internal sqlite database	true
internalDatabase.database	Name of the existing database	nextcloud
externalDatabase.enabled	Whether to use external database	false
externalDatabase.type	External database type: mysql, postgresql	mysql
externalDatabase.host	Host of the external database	nil
externalDatabase.database	Name of the existing database	nextcloud
externalDatabase.user	Existing username in the external db	nextcloud
externalDatabase.password	Password for the above username	nil
mariadb.enabled	Whether to use the MariaDB chart	false
mariadb.db.name	Database name to create	nextcloud
mariadb.db.password	Password for the database	changeme
mariadb.db.user	Database user to create	nextcloud
mariadb.rootUser.password	MariaDB admin password	nil
redis.enabled	Whether to install/use redis for locking	false
cronjob.enabled	Whether to enable/disable cronjob	false
cronjob.schedule	Schedule for the CronJob	*/15 * * * *
cronjob.annotations	Annotations to add to the cronjob	{}
cronjob.curlInsecure	Set insecure (-k) option to curl	false
cronjob.failedJobsHistoryLimit	Specify the number of failed Jobs to keep	5
cronjob.successfulJobsHistoryLimit	Specify the number of completed Jobs to keep	2
cronjob.resources	Cronjob Resources	nil
cronjob.nodeSelector	Cronjob Node selector	nil
cronjob.tolerations	Cronjob tolerations	nil
cronjob.affinity	Cronjob affinity	nil
service.type	Kubernetes Service type	ClusterIp
service.loadBalancerIP	LoadBalancerIp for service type LoadBalancer	nil
persistence.enabled	Enable persistence using PVC	false
persistence.annotations	PVC annotations	{}
persistence.storageClass	PVC Storage Class for nextcloud volume	nil (uses alpha storage class annotation)
persistence.existingClaim	An Existing PVC name for nextcloud volume	nil (uses alpha storage class annotation)
persistence.accessMode	PVC Access Mode for nextcloud volume	ReadWriteOnce
persistence.size	PVC Storage Request for nextcloud volume	8Gi
resources	CPU/Memory resource requests/limits	{}
livenessProbe.enabled	Turn on and off liveness probe	true
livenessProbe.initialDelaySeconds	Delay before liveness probe is initiated	30
livenessProbe.periodSeconds	How often to perform the probe	15
livenessProbe.timeoutSeconds	When the probe times out	5
livenessProbe.failureThreshold	Minimum consecutive failures for the probe	3
livenessProbe.successThreshold	Minimum consecutive successes for the probe	1
readinessProbe.enabled	Turn on and off readiness probe	true
readinessProbe.initialDelaySeconds	Delay before readiness probe is initiated	30
readinessProbe.periodSeconds	How often to perform the probe	15
readinessProbe.timeoutSeconds	When the probe times out	5
readinessProbe.failureThreshold	Minimum consecutive failures for the probe	3
readinessProbe.successThreshold	Minimum consecutive successes for the probe	1

Note:

For nextcloud to function correctly, you should specify the nextcloud.host parameter to specify the FQDN (recommended) or the public IP address of the nextcloud service.

Optionally, you can specify the service.loadBalancerIP parameter to assign a reserved IP address to the nextcloud service of the chart. However please note that this feature is only available on a few cloud providers (f.e. GKE).

To reserve a public IP address on GKE:

$ gcloud compute addresses create nextcloud-public-ip

The reserved IP address can be associated to the nextcloud service by specifying it as the value of the service.loadBalancerIP parameter while installing the chart.

Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,

$ helm install --name my-release \
  --set nextcloud.username=admin,nextcloud.password=password,mariadb.rootUser.password=secretpassword \
    stable/nextcloud

The above command sets the nextcloud administrator account username and password to admin and password respectively. Additionally, it sets the MariaDB root user password to secretpassword.

Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. For example,

$ helm install --name my-release -f values.yaml stable/nextcloud

Tip: You can use the default values.yaml

Persistence

The Nextcloud image stores the nextcloud data and configurations at the /var/www/html paths of the container.

Persistent Volume Claims are used to keep the data across deployments. This is known to work in GCE, AWS, and minikube. See the Configuration section to enable persistence and configuration of the PVC.

Cronjob

This chart can utilize Kubernetes CronJob resource to execute background tasks.

To use this functionality, set cronjob.enabled parameter to true and switch background mode to Webcron in your nextcloud settings page. See the Configuration section for further configuration of the cronjob resource.

Note: For the cronjobs to work correctly, ingress must be also enabled (set ingress.enabled to true) and nextcloud.host has to be publicly resolvable.

Multiple config.php file

Nextcloud supports loading configuration parameters from multiple files. You can add arbitrary files ending with .config.php in the config/ directory. See documentation.

For example, following config will configure Nextcloud with S3 as primary storage by creating file /var/www/html/config/s3.config.php:

nextcloud:
  configs:
    s3.config.php: |-
      <?php
      $CONFIG = array (
        'objectstore' => array(
          'class' => '\\OC\\Files\\ObjectStore\\S3',
          'arguments' => array(
            'bucket'     => 'my-bucket',
            'autocreate' => true,
            'key'        => 'xxx',
            'secret'     => 'xxx',
            'region'     => 'us-east-1',
            'use_ssl'    => true
          )
        )
      );