nixpkgs/nixos/doc/manual
Maximilian Bosch 3944aa051c
nixos/nextcloud: write config to additional config file
One of the main problems of the Nextcloud module is that it's currently
not possible to alter e.g. database configuration after the initial
setup as it's written by their imperative installer to a file.

After some research[1] it turned out that it's possible to override all values
with an additional config file. The documentation has been
slightly updated to remain up-to-date, but the warnings should
remain there as the imperative configuration is still used and may cause
unwanted side-effects.

Also simplified the postgresql test which uses `ensure{Databases,Users}` to
configure the database.

Fixes #49783

[1] https://github.com/NixOS/nixpkgs/issues/49783#issuecomment-483063922
2019-07-22 18:29:52 +02:00
..
administration doc: Use prompt more often 2019-06-17 13:25:50 +02:00
configuration Merge pull request #63639 from Ekleog/fix-matrix-doc 2019-07-13 18:17:14 +02:00
development doc: Use prompt more often 2019-06-17 13:25:50 +02:00
installation doc: Use prompt more often 2019-06-17 13:25:50 +02:00
release-notes nixos/nextcloud: write config to additional config file 2019-07-22 18:29:52 +02:00
.gitignore nixos docs: ignore generated files 2018-05-01 19:50:02 -04:00
default.nix Merge pull request #55436 from layus/warn-manual-ids 2019-03-09 08:21:07 -05:00
Makefile nixos manual Makefile: improve purity 2019-03-22 14:48:08 +01:00
man-configuration.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
man-nixos-build-vms.xml nixos-build-vms: pass --option to nix-build 2019-02-04 10:46:12 +01:00
man-nixos-enter.xml nixos/doc: ran make format 2018-05-31 21:03:51 -04:00
man-nixos-generate-config.xml doc: Use prompt more often 2019-06-17 13:25:50 +02:00
man-nixos-install.xml doc: Use prompt more often 2019-06-17 13:25:50 +02:00
man-nixos-option.xml doc: Use prompt more often 2019-06-17 13:25:50 +02:00
man-nixos-rebuild.xml doc: Use prompt more often 2019-06-17 13:25:50 +02:00
man-nixos-version.xml nixos/doc: ran make format 2018-05-31 21:03:51 -04:00
man-pages.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
manual.xml docs: format 2018-09-29 20:51:11 -04:00
options-to-docbook.xsl nixos: Split paras by \n\n in option descriptions 2018-09-02 08:10:37 +02:00
postprocess-option-descriptions.xsl nixos: Split paras by \n\n in option descriptions 2018-09-02 08:10:37 +02:00
README nixos/doc/manual: Fix typos in README. 2014-07-23 15:00:25 +02:00
shell.nix doc: Adds xml fixing script. (see previous and next commits) 2018-05-31 21:02:15 -04:00

To build the manual, you need Nix installed on your system (no need
for NixOS). To install Nix, follow the instructions at

    https://nixos.org/nix/download.html

When you have Nix on your system, in the root directory of the project
(i.e., `nixpkgs`), run:

    nix-build nixos/release.nix -A manual.x86_64-linux

When this command successfully finishes, it will tell you where the
manual got generated.