Archived
1
0
Fork 0

doc: Add container example to run a web browser.

* doc/guix.texi (Invoking `guix environment'): Add paragraph and example to
  run Eolie in a guix environment container.  Add `container' cindex for the
  first container example, and the `certificates' cindex for the web browser
  example.
This commit is contained in:
Pierre Neidhardt 2020-05-03 10:08:56 +02:00
parent e5f1f5ce07
commit 60131df02b
No known key found for this signature in database
GPG key ID: 9BDCF497A4BBCC7F

View file

@ -4777,6 +4777,7 @@ additionally includes Git and strace:
guix environment --pure guix --ad-hoc git strace guix environment --pure guix --ad-hoc git strace
@end example @end example
@cindex container
Sometimes it is desirable to isolate the environment as much as Sometimes it is desirable to isolate the environment as much as
possible, for maximal purity and reproducibility. In particular, when possible, for maximal purity and reproducibility. In particular, when
using Guix on a host distro that is not Guix System, it is desirable to using Guix on a host distro that is not Guix System, it is desirable to
@ -4793,6 +4794,22 @@ guix environment --ad-hoc --container guile -- guile
The @code{--container} option requires Linux-libre 3.19 or newer. The @code{--container} option requires Linux-libre 3.19 or newer.
@end quotation @end quotation
@cindex certificates
Another typical use case for containers is to run security-sensitive
applications such as a web browser. To run Eolie, we must expose and
share some files and directories; we include @code{nss-certs} and expose
@file{/etc/sll/certs/} for HTTPS authentication; finally we preserve the
the @code{DISPLAY} environment variable since containerized graphical
applications won't display without it.
@example
guix environment --preserve='^DISPLAY$' --container --network \
--expose=/etc/machine-id \
--expose=/etc/ssl/certs/ \
--share=$HOME/.local/share/eolie/=$HOME/.local/share/eolie/ \
--ad-hoc eolie nss-certs dbus -- eolie
@end example
The available options are summarized below. The available options are summarized below.
@table @code @table @code