summary refs log tree commit diff
path: root/nixos/doc/manual/installation
diff options
context:
space:
mode:
authorEelco Dolstra <eelco.dolstra@logicblox.com>2015-09-02 15:38:06 +0200
committerEelco Dolstra <eelco.dolstra@logicblox.com>2015-09-02 16:17:32 +0200
commite70f8c58cc145cc2dd833388a3279988ec5b44d6 (patch)
tree9cdef73abd5832348e1b0791187a8d07811f5bfa /nixos/doc/manual/installation
parentf0e67b927fb4894da6ee670eb445953fdd06cefe (diff)
downloadnixlib-e70f8c58cc145cc2dd833388a3279988ec5b44d6.tar
nixlib-e70f8c58cc145cc2dd833388a3279988ec5b44d6.tar.gz
nixlib-e70f8c58cc145cc2dd833388a3279988ec5b44d6.tar.bz2
nixlib-e70f8c58cc145cc2dd833388a3279988ec5b44d6.tar.lz
nixlib-e70f8c58cc145cc2dd833388a3279988ec5b44d6.tar.xz
nixlib-e70f8c58cc145cc2dd833388a3279988ec5b44d6.tar.zst
nixlib-e70f8c58cc145cc2dd833388a3279988ec5b44d6.zip
Manual: Document system.autoUpgrade
Diffstat (limited to 'nixos/doc/manual/installation')
-rw-r--r--nixos/doc/manual/installation/upgrading.xml26
1 files changed, 26 insertions, 0 deletions
diff --git a/nixos/doc/manual/installation/upgrading.xml b/nixos/doc/manual/installation/upgrading.xml
index 5a9d1f24f7c7..c4812cc637c3 100644
--- a/nixos/doc/manual/installation/upgrading.xml
+++ b/nixos/doc/manual/installation/upgrading.xml
@@ -107,4 +107,30 @@ newer Nix version, which may involve an upgrade of Nix’s database
 schema.  This cannot be undone easily, so in that case you will not be
 able to go back to your original channel.</para></warning>
 
+
+<section><title>Automatic Upgrades</title>
+
+<para>You can keep a NixOS system up-to-date automatically by adding
+the following to <filename>configuration.nix</filename>:
+
+<programlisting>
+system.autoUpgrade.enable = true;
+</programlisting>
+
+This enables a periodically executed systemd service named
+<literal>nixos-upgrade.service</literal>. It runs
+<command>nixos-rebuild switch --upgrade</command> to upgrade NixOS to
+the latest version in the current channel. (To see when the service
+runs, see <command>systemctl list-timers</command>.)  You can also
+specify a channel explicitly, e.g.
+
+<programlisting>
+system.autoUpgrade.channel = https://nixos.org/channels/nixos-15.09;
+</programlisting>
+
+</para>
+
+</section>
+
+
 </chapter>