.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
.TH GUIX "1" "November 2022" "GNU" "User Commands"
.SH NAME
guix \- manual page for guix package (GNU Guix) 1.3.0.27848-a3264
.SH SYNOPSIS
.B guix
\fI\,package \/\fR[\fI\,OPTION\/\fR]...
.SH DESCRIPTION
Install, remove, or upgrade packages in a single transaction.
.TP
\fB\-i\fR, \fB\-\-install\fR PACKAGE ...
install PACKAGEs
.TP
\fB\-e\fR, \fB\-\-install\-from\-expression\fR=\fI\,EXP\/\fR
install the package EXP evaluates to
.TP
\fB\-f\fR, \fB\-\-install\-from\-file\fR=\fI\,FILE\/\fR
install the package that the code within FILE
evaluates to
.TP
\fB\-r\fR, \fB\-\-remove\fR PACKAGE ...
remove PACKAGEs
.HP
\fB\-u\fR, \fB\-\-upgrade\fR[=\fI\,REGEXP\/\fR] upgrade all the installed packages matching REGEXP
.TP
\fB\-m\fR, \fB\-\-manifest\fR=\fI\,FILE\/\fR
create a new profile generation with the manifest
from FILE
.HP
\fB\-\-do\-not\-upgrade\fR[=\fI\,REGEXP\/\fR] do not upgrade any packages matching REGEXP
.TP
\fB\-\-roll\-back\fR
roll back to the previous generation
.TP
\fB\-\-search\-paths\fR[=\fI\,KIND\/\fR]
display needed environment variable definitions
.TP
\fB\-l\fR, \fB\-\-list\-generations\fR[=\fI\,PATTERN\/\fR]
list generations matching PATTERN
.TP
\fB\-d\fR, \fB\-\-delete\-generations\fR[=\fI\,PATTERN\/\fR]
delete generations matching PATTERN
.TP
\fB\-S\fR, \fB\-\-switch\-generation\fR=\fI\,PATTERN\/\fR
switch to a generation matching PATTERN
.TP
\fB\-\-export\-manifest\fR
print a manifest for the chosen profile
.TP
\fB\-\-export\-channels\fR
print channels for the chosen profile
.TP
\fB\-p\fR, \fB\-\-profile\fR=\fI\,PROFILE\/\fR
use PROFILE instead of the user's default profile
.TP
\fB\-\-list\-profiles\fR
list the user's profiles
.HP
\fB\-\-allow\-collisions\fR do not treat collisions in the profile as an error
.TP
\fB\-\-bootstrap\fR
use the bootstrap Guile to build the profile
.TP
\fB\-v\fR, \fB\-\-verbosity\fR=\fI\,LEVEL\/\fR
use the given verbosity LEVEL
.TP
\fB\-s\fR, \fB\-\-search\fR=\fI\,REGEXP\/\fR
search in synopsis and description using REGEXP
.TP
\fB\-I\fR, \fB\-\-list\-installed\fR[=\fI\,REGEXP\/\fR]
list installed packages matching REGEXP
.TP
\fB\-A\fR, \fB\-\-list\-available\fR[=\fI\,REGEXP\/\fR]
list available packages matching REGEXP
.TP
\fB\-\-show\fR=\fI\,PACKAGE\/\fR
show details about PACKAGE
.TP
\fB\-L\fR, \fB\-\-load\-path\fR=\fI\,DIR\/\fR
prepend DIR to the package module search path
.TP
\fB\-K\fR, \fB\-\-keep\-failed\fR
keep build tree of failed builds
.TP
\fB\-k\fR, \fB\-\-keep\-going\fR
keep going when some of the derivations fail
.TP
\fB\-n\fR, \fB\-\-dry\-run\fR
do not build the derivations
.TP
\fB\-\-fallback\fR
fall back to building when the substituter fails
.TP
\fB\-\-no\-substitutes\fR
build instead of resorting to pre\-built substitutes
.TP
\fB\-\-substitute\-urls\fR=\fI\,URLS\/\fR
fetch substitute from URLS if they are authorized
.TP
\fB\-\-no\-grafts\fR
do not graft packages
.TP
\fB\-\-no\-offload\fR
do not attempt to offload builds
.TP
\fB\-\-max\-silent\-time\fR=\fI\,SECONDS\/\fR
mark the build as failed after SECONDS of silence
.TP
\fB\-\-timeout\fR=\fI\,SECONDS\/\fR
mark the build as failed after SECONDS of activity
.TP
\fB\-\-rounds\fR=\fI\,N\/\fR
build N times in a row to detect non\-determinism
.TP
\fB\-c\fR, \fB\-\-cores\fR=\fI\,N\/\fR
allow the use of up to N CPU cores for the build
.TP
\fB\-M\fR, \fB\-\-max\-jobs\fR=\fI\,N\/\fR
allow at most N build jobs
.TP
\fB\-\-debug\fR=\fI\,LEVEL\/\fR
produce debugging output at LEVEL
.TP
\fB\-\-help\-transform\fR
list package transformation options not shown here
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
display version information and exit
.SH "REPORTING BUGS"
Report bugs to: bug\-guix@gnu.org.
.br
GNU Guix home page: <https://www.gnu.org/software/guix/>
.br
General help using Guix and GNU software: <https://guix.gnu.org/en/help/>
.SH COPYRIGHT
Copyright \(co 2022 the Guix authors
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B guix
is maintained as a Texinfo manual.  If the
.B info
and
.B guix
programs are properly installed at your site, the command
.IP
.B info guix
.PP
should give you access to the complete manual.