Open Infrastructure

h1. The ungleich nextcloud guide

{{toc}}

h2. Status

This document is *IN PROGRESS*.

cloud.ungleich.ch is in production

h2. SEE ALSO

See [[datacenterlight:Glarnercloud]] for specific information for the Glarnercloud setup.

See "__ungleich_nextcloud":https://code.ungleich.ch/ungleich-public/__ungleich_nextcloud for specific parameters etc.

See "Nextcloud Admin Manual":https://docs.nextcloud.com/server/stable/admin_manual for the nextcloud documentation

h2. Installation

The installation is done with cdist. To be more specific, with the "__ungleich_nextcloud":https://code.ungleich.ch/ungleich-public/__ungleich_nextcloud cdist type.

The cdist type takes care of the following things:

# Installation of the necessary packages

# Configure php-fpm

# Setting up letsencrypt certificates

# Setting up nginx

# Setting up PostgreSQL

# Installation of nextcloud in _/var/www/nextcloud_

The manifest for cloud.ungleich.ch takes also care of:

# Deploying staff and backup ssh-keys

# Firewall setup

h2. Update

Procedure:

# Go to settings page (webbrowser) to see if all the checks are passed.

# SSH into the machine and go to _/var/www/nextcloud/updater_

# Run the following command:

<pre>

sudo -u www-data php updater.phar

</pre>

h2. Backup

cloud.ungleich.ch is backed up daily to backup.place5.ungleich.ch and backup.place6.ungleich.ch 

h2. Known Issues

h3. No auto updating

The updating procedure is manual done as instructed in [[The ungleich Nextcloud guide#Update]]

h3. Cdist type

The cdist type has several issues:

* The _--domain_ parameter should not have a default value. On the other hand, the manifest should then use the _$__target_host_ approach for this parameter

* The letsecnrypt configuration should probably be outsourced to the letsencrypt type (e.g. the nextcloud type should only setup the nextcloud instance on port 80, rest should be done in the main manifest. This would make the type more generic)