all-in-one/nextcloud-aio-helm-chart
Simon L. 9341392c00
Merge pull request #5689 from nextcloud/enh/noid/add-healthcheck
containers-schema.json: add healtchecks
2024-12-03 15:46:01 +01:00
..
templates Reapply "helm: add a default for RPSS_ENABLED" 2024-11-26 11:16:33 +01:00
Chart.yaml increase helm to 10.0.0 2024-12-03 15:15:48 +01:00
readme.md
update-helm.sh adjust update-helm script to enable readiness check 2024-12-03 15:44:32 +01:00
values.yaml Helm Chart updates 2024-11-26 09:42:56 +00:00

Nextcloud AIO Helm-chart

You can run the containers that are build for AIO with Kubernetes using this Helm chart. This comes with a few downsides, that are discussed below.

Advantages

  • You can run it without a container having access to the docker socket
  • You can run the containers with Kubernetes

Disadvantages

  • You lose the AIO interface
  • You lose update notifications and automatic updates
  • You lose all AIO backup and restore features
  • You lose all community containers: https://github.com/nextcloud/all-in-one/tree/main/community-containers#community-containers
  • You need to know what you are doing
  • For updating, you need to strictly follow the at the bottom described update routine
  • You need to monitor yourself if the volumes have enough free space and increase them if they don't by adjusting their size in values.yaml
  • Probably more

How to use this?

First download this file: https://raw.githubusercontent.com/nextcloud/all-in-one/main/nextcloud-aio-helm-chart/values.yaml and adjust at least all values marked with # TODO!
⚠️ Warning: Do not use the symbols @ and : in your passwords. These symbols are used to build database connection strings. You will experience issues when using these symbols!

Then run:

helm repo add nextcloud-aio https://nextcloud.github.io/all-in-one/
helm install nextcloud-aio nextcloud-aio/nextcloud-aio-helm-chart -f values.yaml

And after a while, everything should be set up.

How to update?

Since the values of this helm chart may change in the future, it is highly recommended to strictly follow the following procedure whenever you want to upgrade it.

  1. Stop all running pods
  2. Back up all volumes that got created by the Helm chart and the values.yaml file
  3. Run helm repo update nextcloud-aio in order to get the updated yaml files from the repository
  4. Now download the updated values.yaml file from https://raw.githubusercontent.com/nextcloud/all-in-one/main/nextcloud-aio-helm-chart/values.yaml and compare that with the one that you currently have locally. Look for variables that changed or got added. You can use the diff command to compare them.
  5. After the file update was successful, simply run helm install my-release nextcloud-aio/nextcloud-aio-helm-chart -f values.yaml to update to the new version.