Unverified Commit 116f14ed authored by Fernando Rodrigues's avatar Fernando Rodrigues
Browse files

nixos/doc: replace nixos-rebuild commands running as root by --use-remote-sudo 



After a discussion on Matrix, it has become clear that building as root
is discouraged, and the (inappropriately named) --use-remote-sudo flag
should be enouraged as the de-facto way to selectively escalate to root
after a system build has finished.

Signed-off-by: default avatarFernando Rodrigues <alpha@sigmasquadron.net>
parent 072a6830

nixos/doc/manual/installation/changing-config.chapter.md

+5 −5
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ configuration of your machine. Whenever you've [changed 
something](#ch-configuration) in that file, you should do



```ShellSession

# nixos-rebuild switch

$ nixos-rebuild switch --use-remote-sudo

```



to build the new configuration, make it the default configuration for
@@ -26,7 +26,7 @@ from a root shell or by prefixing them with `sudo -i`. 
You can also do



```ShellSession

# nixos-rebuild test

$ nixos-rebuild test --use-remote-sudo

```



to build the configuration and switch the running system to it, but
@@ -37,7 +37,7 @@ configuration. 
There is also



```ShellSession

# nixos-rebuild boot

$ nixos-rebuild boot --use-remote-sudo

```



to build the configuration and make it the boot default, but not switch
@@ -47,7 +47,7 @@ You can make your configuration show up in a different submenu of the 
GRUB 2 boot screen by giving it a different *profile name*, e.g.



```ShellSession

# nixos-rebuild switch -p test

$ nixos-rebuild switch -p test --use-remote-sudo

```



which causes the new configuration (and previous ones created using
@@ -58,7 +58,7 @@ configurations. 
A repl, or read-eval-print loop, is also available. You can inspect your configuration and use the Nix language with



```ShellSession

# nixos-rebuild repl

$ nixos-rebuild repl

```



Your configuration is loaded into the `config` variable. Use tab for autocompletion, use the `:r` command to reload the configuration files. See `:?` or [`nix repl` in the Nix manual](https://nixos.org/manual/nix/stable/command-ref/new-cli/nix3-repl.html) to learn more.