Nextcloud
Nextcloud is an open-source, self-hostable cloud
platform. The server setup can be automated using
services.nextcloud. A desktop client is packaged
at pkgs.nextcloud-client.
Basic usage
Nextcloud is a PHP-based application which requires an HTTP server
(services.nextcloud optionally supports
services.nginx) and a database
(it's recommended to use services.postgresql).
A very basic configuration may look like this:
{ pkgs, ... }:
{
services.nextcloud = {
enable = true;
hostName = "nextcloud.tld";
nginx.enable = true;
config = {
dbtype = "pgsql";
dbuser = "nextcloud";
dbhost = "/tmp"; # nextcloud will add /.s.PGSQL.5432 by itself
dbname = "nextcloud";
adminpassFile = "/path/to/admin-pass-file";
adminuser = "root";
};
};
services.postgresql = {
enable = true;
initialScript = pkgs.writeText "psql-init" ''
CREATE ROLE nextcloud WITH LOGIN;
CREATE DATABASE nextcloud WITH OWNER nextcloud;
'';
};
# ensure that postgres is running *before* running the setup
systemd.services."nextcloud-setup" = {
requires = ["postgresql.service"];
after = ["postgresql.service"];
};
networking.firewall.allowedTCPPorts = [ 80 443 ];
}
The options hostName and nginx.enable are used internally to configure an
HTTP server using PHP-FPM and nginx.
The config attribute set is used for the config.php which is used
for the application's configuration.
Beware: this isn't entirely pure since the config is modified by the application's runtime!
In case the application serves multiple hosts (those are checked with
$_SERVER['HTTP_HOST'])
those can be added using
services.nextcloud.config.extraTrustedDomains.
Pitfalls
Unfortunately Nextcloud appears to be very stateful when it comes to managing its own configuration. The
config file lives in the home directory of the nextcloud user (by default
/var/lib/nextcloud/config/config.php) and is also used to track several
states of the application (e.g. whether installed or not).
Right now changes to the services.nextcloud.config attribute set won't take effect
after the first install
(except services.nextcloud.config.extraTrustedDomains) since the actual configuration
file is generated by the NextCloud installer which also sets up critical parts such as the database
structure.
Warning: don't delete config.php! This file tracks the application's state and a deletion can cause unwanted side-effects!Warning: don't rerun nextcloud-occ maintenance:install! This command tries to install the application and can cause unwanted side-effects!
The issues are known and reported in #49783, for now it's unfortunately necessary to manually work around these issues.