(4/8) Deploy NextCloud on Kuberbetes The self-hosted Dropbox

This article is part of the series Build your very own self-hosting platform with Raspberry Pi and Kubernetes

  1. Introduction
  2. Install Raspbian Operating-System and prepare the system for Kubernetes
  3. Install and configure a Kubernetes cluster with k3s to self-host applications
  4. Deploy NextCloud on Kuberbetes: The self-hosted Dropbox
  5. Self-host your Media Center On Kubernetes with Plex, Sonarr, Radarr, Transmission and Jackett
  6. Self-host Pi-Hole on Kubernetes and block ads and trackers at the network level
  7. Self-host your password manager with Bitwarden
  8. Deploy Prometheus and Grafana to monitor a Kubernetes cluster


Now we have prepared our RaspberryPi cluster to receive Kubernetes as a self-hosting platform, it's time to start installing applications !

NextCloud is an file hosting open-source software similar to Dropbox. Unlike Dropbox, NextCloud is not available as a SaaS but only on-premise which means anyone is allowed to install and operate it on their own private server. NextCloud offers individuals and organisations to gain control over their private data with a safe and secure solutions. NextCloud also provides a long list of add-ons working alongside the file sharing solution such as: Calendar & Contacts management, Audio/Video conferencing, Task Management, Photos albums and more.

In this article we will learn how to safely install NextCloud on a Kubernetes environment and configure both Desktop and Mobile access from anywhere.


In order to run entirely the tutorial, we will need:


We are going to isolate all the Kubernetes objects related to NextCloud in the namespace nextcloud.

To create a namespace, run the following command:

$ kubectl create namespace nextcloud


The first step consists in setting up a volume to store our NextCloud data (files and database). If you followed the previous articles to install and configure a self-hosting platform using RaspberryPi and Kubernetes, you remember we have on each worker a NFS client pointing to a SSD on /mnt/ssd.

1. Deploy the Persistent Volume (PV)

The Persistent Volume specify the name, the size, the location and the access modes of the volume:

Create the following file and apply it to the k8 cluster.

## nextcloud.persistentvolume.yml
apiVersion: v1
kind: PersistentVolume
  name: "nextcloud-ssd"
    type: "local"
  storageClassName: "manual"
    storage: "50Gi"
    - ReadWriteOnce
    path: "/mnt/ssd/nextcloud"
$ kubectl apply -f nextcloud.persistentvolume.yml
persistentvolume/nextcloud-ssd created

You can verify the PV exists with the following command:

$ kubectl get pv

nextcloud-ssd   50Gi       RWO            Retain           Available           manual                  34s

2. Create the Persistent Volume Claim (PVC)

The Persistent Volume Claim is used to map a Persistent Volume to a deployment or stateful set. Unlike the PV, the PVC belongs to a namespace.

Create the following file and apply it to the k8 cluster.

## nextcloud.persistentvolumeclaim.yml
apiVersion: v1
kind: PersistentVolumeClaim
  namespace: "nextcloud"
  name: "nextcloud-ssd"
  storageClassName: "manual"
    - ReadWriteOnce
      storage: "50Gi"
$ kubectl apply -f nextcloud.persistentvolumeclaim.yml
persistentvolumeclaim/nextcloud-ssd created

You can verify the PVC exists with the following command:

$ kubectl get pvc -n nextcloud

nextcloud-ssd   Bound    nextcloud-ssd   50Gi       RWO            manual         26s


In the next part, we are now going to deploy NextCloud using the stable/nextcloud Helm chart.

1. Download the Chart values of the chart locally

Run the following command to download the Chart values into the local file nextcloud.values.yml.

$ helm show values stable/nextcloud >> nextcloud.values.yml

If you open the file, you will see the default configuration values to setup NextCloud. Instead of using the flag --set property=value like before, we will use the file nextcloud.values.yml to make all the changes.

2. Update the values

We now need to update a few properties before installing the Helm chart. Open the file nextcloud.values.yml and change the following properties (replace the information surrounded by with your information).

## nextcloud.values.yml
  host: "nextcloud.<domain.com>" # Host to reach NextCloud
  username: "admin" # Admin
  password: "<PASSWORD>" # Admin Password
  enabled: true # Change to true
  existingClaim: "nextcloud-ssd" # Persistent Volume Claim created earlier
  accessMode: ReadWriteOnce
  size: "50Gi"

Take a look at the file if you want to make more customisation to NextCloud:

3. Install the Chart

In the part, we will install the Helm chart under the namespace nextcloud with nextcloud.values.yml as configuration file.

$ helm install nextcloud stable/nextcloud \
  --namespace nextcloud \
  --values nextcloud.values.yml

After a couple of minutes, check if the pod and service is up and running:

$ kubectl get pods -n nextcloud

NAME                         READY   STATUS    RESTARTS   AGE   IP           NODE          NOMINATED NODE   READINESS GATES
nextcloud-78f5564f89-854jr   1/1     Running   0          15m   kube-master   <none>           <none>
$ kubectl get services -n nextcloud -o wide

nextcloud   ClusterIP   <none>        8080/TCP   51m   app.kubernetes.io/name=nextcloud

4. Debugging

You can check the logs with the following command:

$ kubectl logs -f nextcloud-78f5564f89-854jr -n nextcloud

Otherwise check the folder /mnt/ssd/nextcloud/data/nextcloud.log.

Outside access

This step is configured before the ingress in order to be able to issue a certificate automatically when we deploy the ingress

The next part consist to enable the connections to NextCloud from outside so you can access your data from anywhere.

1. Port Forwarding

First you need to go to your router setup and add a port-forwarding rule to map any incoming requests on port 80 or port 443 to be forwarded to (the LoadBalancer IP of the Nginx).

VirginHub - Port-Forwarding

2. Map the subdomain nextcloud.<domain.com> to your home router

First you need to find out what's your router external IP, run this command or go to whatismyip.com.

$ curl ipecho.net/plain

Then, we need to configure our subdomain to make sure nextcloud.<domain.com> resolves to our external static IP. Go to your domain provider console / DNS management add a record:



At this point, the application (pod nextcloud-78f5564f89-854jr) is only accessible within the cluster on port 8080. To make it accessible from outside the cluster (on our network), we need to deploy an Ingress mapping service:port to a route of the Nginx proxy.

Because, this route will also be exposed over the Internet, we will also issue a certificate to encrypt the traffic with SSL.

1. Create the ingress config file

Create the file nextcloud.ingress.yml containing:

## nextcloud.ingress.yml
apiVersion: extensions/v1beta1
kind: Ingress
  namespace: "nextcloud" # Same namespace as the deployment
  name: "nextcloud-ingress" # Name of the ingress (see kubectl get ingress -A)
    kubernetes.io/ingress.class: "nginx"
    cert-manager.io/cluster-issuer: "letsencrypt-prod" # Encrypt using the ClusterIssuer deployed while setting up Cert-Manager
    nginx.ingress.kubernetes.io/proxy-body-size:  "50m" # Increase the size of the maximum allowed size of the client request body
  - hosts:
    - "nextcloud.<domain.com>" # Host to access nextcloud
    secretName: "nextcloud-prod-tls" # Name of the certifciate (see kubectl get certificate -A)
  - host: "nextcloud.<domain.com>" # Host to access nextcloud
        - path: /  # We will access NextCloud via the URL https://nextcloud.<domain.com>/
            serviceName: "nextcloud" # Mapping to the service (see kubectl get services -n nextcloud)
            servicePort: 8080 # Mapping to the port (see kubectl get services -n nextcloud)

2. Deploy the Ingress

Now deploy the ingress:

$ kubectl apply -f nextcloud.ingress.yml
ingress.extensions/nextcloud-ingress created

3. Check the certificate issuance

After you deployed the ingress, a certificate should be issued, check the certificaterequest and certificate (it might take a couple of minutes to be READY):

$ kubectl get certificaterequest -n nextcloud -o wide

NAMESPACE   NAME                         READY   ISSUER             STATUS                                         AGE
nextcloud   nextcloud-prod-tls-9929727   True    letsencrypt-prod   Certificate fetched from issuer successfully   17m

$ kubectl get certificate -n nextcloud -o wide

NAMESPACE   NAME                 READY   SECRET                           ISSUER             STATUS                                          AGE
nextcloud   nextcloud-prod-tls   True    nextcloud-prod-tls   letsencrypt-prod   Certificate is up to date and has not expired   17m


Alright, still with me :) You can now try to access your NextCloud instance using your browser, mobile or the Android/iOS app from home or outside via https://nextcloud..

Connect with the user admin and the password configured in the file nextcloud.values.yml.

You can also download the Android or iOS app and access you data, sync automatically your photos and more.