Nextcloud¶
What is it¶
Nextcloud is files, calendar and contacts for a team, with OnlyOffice document editing, a whiteboard, push notifications and, as options, Talk, mail and an AI assistant. The app and its database run in a project of your own, with a daily database backup.
The platform offers it as a managed application: an Argo CD Application the platform
creates for you - from the shop or from the marketplace's Nextcloud (managed) template -
and keeps in sync with the chart. Its secrets are generated once at deployment, its
hostname sits on the app domain of your cluster, and the platform watches its health. The
same chart installed by you (helm install, or the plain template) is unmanaged: it
runs in your project like any other workload, and nothing on the platform side follows it.
How to create¶
Through the marketplace. In the console (web.grn.cloud) open
the Developer Catalog, choose Nextcloud (managed) and fill in the application name, the hostname, the storage size and the switches for push, whiteboard, backup, Talk, monitoring, mail and the AI assistant. The result is an
Application in your home project; its resource tree shows the project it creates and
what runs in it. The deployment also appears as an order in the shop,
so your account lists every application you run; a paid product is billed from the day of the
deployment.
Through the shop. Nextcloud Free, Basic and Pro in the shop (monthly or yearly), on the compute cluster: your Nextcloud answers at https://<hostname>.apps.grn.cloud. The plans differ in storage; the hostname is the option on every one of them. Type the hostname on the order line and confirm; a mail tells you when the application is reachable, with its address and a link to the Application in the console. The first order also creates your cloud account on that cluster (welcome mails).
How to make changes¶
Configuration lives in the Application: open it in the GitOps page of the console, and
the YAML tab shows the chart values under spec.source.helm.valuesObject - that is
where the admin password and the database, redis and whiteboard secrets are read. Values the platform set for you (the hostname, the generated
secrets) are kept; the other values are yours to change, and Argo CD applies the change at
the next sync. Change the settings of an application walks
through it.
A shop application follows its order line: a larger plan, another storage size or a new hostname is a change of the subscription in the shop (or a new order line), and the platform updates the application to match; the chart version follows the product. A marketplace application's chart version is its own targetRevision: Versions, upgrades and removal covers both.
How to cancel¶
Ordered in the shop: cancel the subscription in the shop. The application is removed ten minutes after the order line ended. Created from the marketplace: delete the Application in the GitOps page; the project it created and everything in it go with it, and the order line in the shop ends within
the hour.
Deletion removes the application's data with it. Make and keep your own backup before you delete: the platform keeps none for you.
References¶
- Nextcloud administration manual
- Nextcloud user manual
- Nextcloud Helm chart
- The chart:
nextcloudin the GRN.CLOUD marketplace repository - Managed applications - the
Application, its secrets and its state - Storage
- Databases