guix/guix
3
5
Fork 0
mirror of git://git.savannah.gnu.org/guix.git synced 2023-12-14 03:33:07 +01:00
Code Issues Releases Wiki Activity

doc: Add details for binary installation.

Browse source 
* doc/guix.texi (Binary Installation): Provide some more details for binary
  installation, in particular automatic starting of the daemon.

Signed-off-by: Andreas Enge <andreas@enge.fr>
This commit is contained in:
George Clemmer 2016-02-18 11:48:28 -05:00 committed by Andreas Enge
parent a40424bd11
commit c8e26887ed
1 changed files with 35 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

53
doc/guix.texi
View file

@ -377,19 +377,29 @@ Create the group and user accounts for build users as explained below
(@pxref{Build Environment Setup}).
@item
Run the daemon:
Run and set the Guix daemon to automatically start on boot.
If your host distro uses the systemd init system:
@example
# cp ~root/.guix-profile/lib/systemd/system/guix-daemon.service \
/etc/systemd/system/
# systemctl start guix-daemon && systemctl enable guix-daemon
@end example
If your host distro uses the Upstart init system:
@example
# ~root/.guix-profile/bin/guix-daemon --build-users-group=guixbuild
# cp ~root/.guix-profile/lib/upstart/system/guix-daemon.conf /etc/init/
@end example
Otherwise, you can still start the daemon manually with:
@example
# ~root/.guix-profile/bin/guix-daemon --build-users-group=guixbuild
@end example
On hosts using the systemd init system, drop
@file{~root/.guix-profile/lib/systemd/system/guix-daemon.service} in
@file{/etc/systemd/system}.
Likewise, on hosts using the Upstart init system, drop
@file{~root/.guix-profile/lib/upstart/system/guix-daemon.conf} in
@file{/etc/init}.
@item
Make the @command{guix} command available to other users on the machine,
@ -425,21 +435,28 @@ authorize them:
@end example
@end enumerate
And that's it! For additional tips and tricks, @pxref{Application
Setup}.
This completes root-level install of Guix. Each user will need to
perform additional steps to make their Guix envionment ready for use,
@pxref{Application Setup}.
The @code{guix} package must remain available in @code{root}'s
profile, or it would become subject to garbage collection---in which
case you would find yourself badly handicapped by the lack of the
@command{guix} command.
The tarball in question can be (re)produced and verified simply by
running the following command in the Guix source tree:
You can confirm that Guix is working by installing a sample package into
the root profile:
@example
make guix-binary.@var{system}.tar.xz
# guix package -i hello
@end example
If your host distro uses @code{locales} that are incompatible with the
@code{glibc} that Guix uses, you will see @code{warning: failed to
install locale: Invalid argument}. This may be ignored, or remedied by
installing Locales as root, @pxref{Application Setup}.
The @code{guix} package must remain available in @code{root}'s profile,
or it would become subject to garbage collection---in which case you
would find yourself badly handicapped by the lack of the @command{guix}
command. In other words, don't remove @code{guix} by running @code{guix
package -r guix}.
@node Requirements
@section Requirements