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 = "/run/postgresql"; # 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.