summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2025-11-02services: gitile: Add git-owner-validation? configuration.Nguyễn Gia Phong
* gnu/services/version-control.scm (gitile-configuration): Add git-owner-validation? field. * doc/guix.text (Version Control Services): Document it. Change-Id: I7d35e66e512fcaae25a5eac138b0fb2437a7c70c
2025-10-31doc: Document hare-build-system.Lilah Tascheter
* doc/guix.texi (Build Systems)[hare-build-system]: New variable doc. Change-Id: I4aee955eb8ea6451340a76cd57671fdc6ba238d9 Signed-off-by: jgart <jgart@dismail.de>
2025-10-24style: Add git-source rule.Nicolas Graves
* guix/scripts/style.scm (transform-to-git-fetch) (url-fetch->git-fetch): New procedures. * doc/guix.texi: Add entry for git-source. * tests/style.scm: Add tests for url-fetch->git-fetch. Change-Id: I6192fba4d84619b81fbc75850542b9dbd2326d4a Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-10-24services: forgejo-runner: Add ‘log-file’ option.Romain GARBAGE
* gnu/services/ci.scm (<forgejo-runner-configuration>) [log-file]: New field. (forgejo-runner-shepherd-service): Use new field. * doc/guix.texi (Continuous Integration): Add documentation. Change-Id: Ie03e6d4b9b4f2c1cad0e9cd20032fca5ae4a4410 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-10-23home: services: bash: Support setting shell variables.Ludovic Courtès
* gnu/home/services.scm (shell-variable-definitions): New procedure. * gnu/home/services/shells.scm (serialize-shell-variables): New procedure. (home-bash-configuration)[variables]: New field. (add-bash-configuration): Honor it. (home-bash-extension)[variables]: New field. (home-bash-extensions): Handle ‘variables’. * doc/guix.texi (Shells Home Services): Update. Change ‘PS1’ example to use ‘variables’, not ‘environment-variables’. * doc/he-config-bare-bones.scm: Use ‘variables’ instead of ‘bash-profile’. Change-Id: I29083d6313d10b1eb9d91eccacfb33efefe60d58
2025-10-23doc: Refer to the Deprecation Policy from “Creating a Channel”.Ludovic Courtès
* doc/guix.texi (Creating a Channel): Reword warning to refer to the deprecation policy. Change-Id: I6c1cd8dfac557634c2963f13f17903f16acbe720
2025-10-23doc: Recommend ‘define-deprecated-package’ in the Deprecation Policy.Ludovic Courtès
* doc/contributing.texi (Deprecation Policy): Document and recommend ‘define-deprecated-package’. Change-Id: I530310f5216f09025525d91f690bb3885fe2cfb4
2025-10-23services: nar-herder: Add control server options.Christopher Baines
* gnu/services/guix.scm (<nar-herder-configuration>): Add control host and control port fields. (nar-herder-shepherd-services): Use them. * doc/guix.texi (Guix Services): Document them. Change-Id: Ie738fb30302496d2ec530ca3b5c8b0628fdd4c05
2025-10-20doc: cookbook: Update command for installing the SICP book.Florian Pelz
Follow-up to commit e5a5b1d66aa3a6d54b28c91f83ea2986ac84fcc6. * doc/guix-cookbook.texi (A Scheme Crash Course): Change command. Change-Id: Ie559fc88738abef0dfa75dfc1d5dc926a618e4c2
2025-10-19doc: cookbook: Minor correction to "Reproducible Research" chapter.Konrad Hinsen
* doc/guix-cookbook.texi (Setting Up the Environment): Reword. Change-Id: Ifaf8b3231fe1b3007dbaaf7005c249fbcdf1deb2 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-10-17doc: cookbook: Fix typos under “Reproducible Research”.Ludovic Courtès
* doc/guix-cookbook.texi (Setting Up the Environment): Remove extra word; add missing word. Change-Id: I41ba29bd81fd6e8262d4112e57e1ff0cce439967
2025-10-14guix: Fix guix-minimal install phase.Nicolas Graves
* doc/local.mk (sub_commands_mans): Add guix-copy conditionally. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-10-13nss: Allow selecting IP protocol for mDNS lookups.Sergey Trofimov
* gnu/system/nss.scm (mdns-host-lookup-nss): New procedure. * doc/guix.texi (Name Service Switch): Document it. Change-Id: Ie4ff4aab6bf41eb2cec69b78a8427594b20bc954 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-10-13doc: cookbook: Add “Reproducible Research” chapter.Ludovic Courtès
* doc/guix-cookbook.texi (Reproducible Research): New node. Change-Id: I73d12771a2c2b5717b8f553dacae272f509a9fed
2025-10-10home: services: Add niri.Oleg Pykhalov
This introduces a new home service for Niri, a scrollable tiling Wayland compositor that combines traditional tiling window management with smooth scrolling between workspaces. The service provides: - home-niri-service-type for installing and configuring Niri - Shepherd service that starts Niri in a DBus session - Proper Wayland environment variables (XDG_CURRENT_DESKTOP, XDG_SESSION_DESKTOP, etc.) - Integration with xdg-desktop-portal and related components The service starts Niri with appropriate environment variables for Wayland compatibility and includes necessary dependencies like xdg-desktop-portal-gnome and xdg-desktop-portal-gtk for proper desktop integration. * gnu/home/services/niri.scm: New file containing the service implementation. * gnu/local.mk (GNU_SYSTEM_MODULES): Register the new module. * doc/guix.texi (Niri window manager): Add comprehensive documentation. Change-Id: I9ef081226b4aaa31706d1fbc0d8b7aa1a202cd6e
2025-10-08doc: cookbook: Fix network bridge qemu example.Gabriel Wicki
* doc/guix-cookbook.texi (Virtual Machines) [Configuring the QEMU bridge helper script]: Fix example. Change-Id: Ia735637ab71928176b33da495d528d1519d29cb9 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-10-07services: libvirt: Add configurable service requirements.Oleg Pykhalov
This enhances flexibility by allowing users to specify custom service dependencies for libvirt, rather than being limited to the default hardcoded requirements. This is particularly useful for complex deployments or when integrating with custom service configurations. Note that default 'dbus-system' requirement may not be strictly necessary for basic libvirt operation. For instance, libvirt can function without issues in many cases even when dbus-system is not included in the requirements, allowing for more minimal deployments. * gnu/services/virtualization.scm (list-of-symbols?, serialize-list-of-symbols): New procedures. (libvirt-configuration): Add 'requirement' field to allow custom service dependencies. (libvirt-shepherd-service): Use the configured requirements instead of hardcoded ones. * doc/guix.texi (Virtualization Services): Document the new 'requirement' option. Change-Id: I05cfbb5227cff9b7d9b55ee37774c96e39c4c526
2025-10-07services: libvirt: Make dmidecode available to fix SMBIOS error.Oleg Pykhalov
The libvirt daemon requires 'dmidecode' to provide Host SMBIOS information to virtual machines. Without it in the PATH, it fails with the error: "Host SMBIOS information is not available". * gnu/services/virtualization.scm (libvirt-configuration): Add 'dmidecode' field to specify the dmidecode package. (libvirt-service-type): Add dmidecode to system profile to ensure it's available in PATH. * doc/guix.texi (Virtualization Services): Document the new 'dmidecode' option. Change-Id: I8e5e565e95149c5aeba2dc0c5c757046efa6de2d
2025-10-06services: log-rotation: Allow to pass procedure as compression method.Benjamin Chabanne
* gnu/services/admin.scm (log-rotation-configuration): Change validation method and accept gexp procedure. Change-Id: I67cd5051a05d211349ecbc66ee3a55ab5b1a5971 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-10-06monad-repl: Add "build-options" command.Tomas Volf
There currently was no way to disable build offload for ,build from inside the REPL. Since offloaded builds sometimes do not error report entirely correctly, it is useful to be able to switch to local builds. This commit adds new ,build-options meta command, which allows to specify build options, including #:offload?. * guix/monad-repl.scm (%build-options): New variable. (evaluate/print-with-store, package-argument-command): Use it. (build-options): New meta command to set it. * doc/guix.texi (Using Guix Interactively): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-10-06mapped-devices/luks: Support extra options.45mg
Allow passing extra options to the 'cryptsetup open' command. * gnu/system/mapped-devices.scm (luks-device-mapping-with-options): [#:extra-options]: New argument. (open-luks-device): Use it. (check-luks-device): Validate it. * doc/guix.texi (Mapped Devices): Document it. * gnu/tests/install.scm (%test-encrypted-root-extra-options-os): New test for it, as well as the previously untested #:allow-discards? option. (%encrypted-root-extra-options-os): New os declaration for the test. Change-Id: I265a431efb0c81ed7cfc984344c6b8a4cc2f1624 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-10-05doc: Build PDF for Chinese manual.Florian Pelz
* doc/build.scm (texinfo-manual-source): Replace input line in Chinese manual, cookbook. (pdf-manual): Adjust comment. Make it use xetex instead of pdftex. (html-manual-indexes)<language-index>: Do not hide the Chinese PDF, but hide the broken Korean cookbook instead, because Hangul are invisible. Fixes: guix/translations#1 Change-Id: If8934cda1387c666076ba47cc2656418a3a4f0f0
2025-09-30services: rottlog: Remove.Nguyễn Gia Phong
* gnu/services/admin.scm (rottlog-service{,-type}, rottlog-configuration{,?,-rottlog,-rc-file,-rotations,-jobs} log-rotation{,?,-frequency,-files,-options,-post-rotate}, %default-rotations, %rotated-files, %default-log-rotation-options): Remove variables. * doc/guix.texi (Rottlog): Remove subheading. * .dir-locals.el: De-register rottlog-configuration. References: a9f21036e43f ("services: rottlog: Deprecate.") Change-Id: I9d62deb4dba31a07c3ef82cde0fca3a05ece064d Signed-off-by: Maxim Cournoyer <maxim@guixotic.coop>
2025-09-30Revert "nls: Temporarily disable building of translated manuals."Florian Pelz
This reverts commit 94d30d4d3b1e86fd3241dd552aa15c0e5541c8f1.
2025-09-30nls: Temporarily disable building of translated manuals.Florian Pelz
* doc/local.mk (info_TEXINFOS, MANUAL_LANGUAGES, COOKBOOK_LANGUAGES): Keep only 'en' for building with 'make'. * guix/self.scm (translate-texi-manuals)[translate-tmp-texi]: Inhibit calling PO4A, so none are built with 'guix pull'. Change-Id: I1a119251f557b5f05c9e972ccb84c04e9267c692
2025-09-30scripts: Honor --target-version in every situation.Maxim Cournoyer
* guix/scripts/refresh.scm (options->update-specs): Always honor --target-version. * doc/guix.texi (Invoking guix refresh): Add an example showing how this can be useful. Change-Id: I55f98c88f4b583f65dd85a6d3573f9bc87a1dead
2025-09-30services: sane: Support pluggable backends.Sergey Trofimov
* gnu/services/desktop.scm (sane-configuration): New record. (sane-service-type): Add native search paths to environment. Change-Id: Ia7b66b62cf027200dd94533f32c1e4bc0ed373d3
2025-09-26services: Add miniflux-service-type.Rodion Goritskov
* doc/guix.texi: Document Miniflux service and configuration. * gnu/services/web.scm: New service. * gnu/services/web.scm: Define shepherd service and account roles. * gnu/tests/web.scm: (%miniflux-create-admin-credentials, miniflux-base-system, %test-miniflux-admin-string, %test-miniflux-admin-file, %test-miniflux-socket): Add system tests for Miniflux service. Change-Id: I4a336e677ec8b46aed632f0ded9cc11c2d38975f Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-09-25doc: Clarify depth argument of build -P is non-optional.Hugo Buddelmeijer
* doc/guix.texi (Additional Build Options): Depth in guix build -P is required. Change-Id: I2cbc149a9fc59a198ceedb06cc1fa5496b4f4c91 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-09-25services: mumi: Add Debbugs rsync as shepherd timer.Arun Isaac
* gnu/services/web.scm (<mumi-configuration>)[data-directory, rsync-remote, rsync-flags]: New fields. (%mumi-worker-log): Delete variable. (%mumi-rsync-and-index-log): New variable. (mumi-rsync-and-index): New function. (mumi-shepherd-services): Remove mumi-worker service. Add mumi-rsync-and-index service. (mumi-service-type): Remove default value. * doc/guix.texi (Web Services)[mumi]: Document data-directory, rsync-remote and rsync-flags fields. Co-authored-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2025-09-24services: nginx: Add stream configuration.Arun Isaac
* gnu/services/web.scm (<nginx-stream-configuration>): New record type. (<nginx-configuration>)[stream]: New field. (emit-nginx-server-config): Add context argument. (default-nginx-config): Serialize stream. * doc/guix.texi (Web Services): Document it.
2025-09-23doc: Clarify how to create the Codeberg token for `sync-codeberg-teams'.Maxim Cournoyer
* doc/contributing.texi (Teams): Mention needed permissions and provide the page URL. Change-Id: I4ba44379a4ce5df9e987b32f28ebac0c7dc35618
2025-09-23doc: Remove docs for non-existent virtio? parameter of raw-initrd.Tom Fitzhenry
virtio? was removed in commit eac026e5c80caae88a6cef317a46007dca343578. * doc/guix.texi (Initial RAM Disk): Remove docs for virtio? in raw-initrd. Change-Id: I99aaf58f0c5239409511146c4617546a202f5041 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-09-23services: dhcpcd: Add shepherd-provision field.Alexey Abramov
* doc/guix.texi (Networking Setup)<dhcpcd-configuration>: Regenerate the dhcpcd-configuration documentation. * gnu/services/networking.scm (dhcpcd-configuration) <shepherd-provision>: Add new field. Fix typo in client-id description. (dhcpcd-shepherd-service): Use it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-09-21doc: Fix documentation of ‘vfs-mapping’.Edouard Klein
* doc/guix.texi (VFS Mapping Service): Fix source/destination mixup. Change-Id: I10bd066369a6507e69a40155dc3faa23cf40c1e6 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-09-18services: oci: Fix OCI backed Shepherd services HOME variable.Giacomo Leidi
This patch allows containers run with podman to run each with their own specific user. * doc/guix.texi: Fix wrong type for oci-container-configuration's shepherd-dependencies field. * gnu/services/containers.scm (oci-container-shepherd-service): In case a specific container is not run through the user provisioned by the oci-service-type, its environment is different from the globally provisioned one and must be recomputed. Change-Id: I5d636ad0616ced0af124002de4403da3067334de Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-09-18Reapply "Update Maxim's email address."Maxim Cournoyer
This reverts commit a7db92d9b389cbe565395523882c34c6eff2c21a, this time with the more careful command, to avoid a world rebuild: grep -rl --exclude-dir=build --exclude-dir=patches --exclude=ld-wrapper.in \ --exclude=sitecustomize.py --exclude=guix-emacs.el maxim.cournoyer@gmail.com | xargs sed -i 's/maxim.cournoyer@gmail.com/maxim@guixotic.coop/g' Change-Id: I0871f5cf9ace79e34e78e24154d0da6ea95a3a91
2025-09-18Revert "Update Maxim's email address."Maxim Cournoyer
This reverts commit d0d87a744d724b7e7d5ac013c586039652087bb3. Oops! This caused a world rebuild. Change-Id: I25fff644b2b61d0ee93d69b457b04c72b5b74d15
2025-09-18Update Maxim's email address.Maxim Cournoyer
The change was automated via: git grep -l maxim.cournoyer@gmail.com | xargs sed -i 's/maxim.cournoyer@gmail.com/maxim@guixotic.coop/g' * .mailmap: New entry. Change-Id: Iaa88b1e51c94159c49138fb43910badb990eb169
2025-09-16doc: Remove broken link.Gabriel Wicki
* doc/contributing.texi: Delete sentence with broken link. Change-Id: I2f0b67e1fa70750414e30d7cd474e1d4d077d9e8
2025-09-14gnu: Remove Tailon services and documentation.Ian Eure
The tailon package was removed in 63023deaf96bd0d90aba262b194bf1445ec5a0b6, but the associated service and documentation weren’t, leading to `guix pull` breaking. Fixes guix/guix#2689. * doc/guix.texi: Remove Tailon documentation. * gnu/services/web.scm (tailon-service-type): Delete variable. (tailon-configuration-file): Delete variable. (tailon-configuration-file?): Delete variable. (tailon-configuration-file-files): Delete variable. (tailon-configuration-file-bind): Delete variable. (tailon-configuration-file-relative-root): Delete variable. (tailon-configuration-file-allow-transfers?): Delete variable. (tailon-configuration-file-follow-names?): Delete variable. (tailon-configuration-file-tail-lines): Delete variable. (tailon-configuration-file-allowed-commands): Delete variable. (tailon-configuration-file-debug?): Delete variable. (tailon-configuration-file-http-auth): Delete variable. (tailon-configuration-file-users): Delete variable (tailon-configuration): Delete variable. (tailon-configuration?): Delete variable. (tailon-configuration-config-file): Delete variable. (tailon-configuration-package): Delete variable. * gnu/tests/web.scm (%test-tailon): Delete variable. Change-Id: I3b507df8233b0440baa6a2bce4604b5813cb3bb0
2025-09-14home: services: home-sway-service-type: Enable extensions.Arnaud Daby-Seesaram
* gnu/home/services/sway.scm (%empty-sway-configuration): New value. (sway-combine): New procedure. (sway-compose): New procedure. (sway-extend): New procedure. (home-sway-service-type) [compose/extend]: New fields. * doc/guix.texi (Sway window manager): Document this. Change-Id: I548a18a6a273380be90c9b5b365f65a93cc02416 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-09-14home: services: Support options for bindings in sway-service-type.Arnaud Daby-Seesaram
* gnu/home/services/sway.scm (make-alist-predicate): Add an optional argument. (bindings?): Remove procedure. (keybinding-options?): New procedures. (codebinding-options?): New procedures. (gesture-options?): New procedures. (mouse-bindings?): Allow to pass options to mouse-bindings. (sway-configuration) [keybindings]: Allow to pass options to key-bindings. [gestures]: Allow to pass options to gesture-bindings. (sway-mode) [keybindings]: Allow to pass options to key-bindings. (serialize-binding): Support options. (serialize-mouse-binding): Support options. (serialize-keybinding): Support options. (serialize-gesture): Support options. (serialize-variable): Inline previous definition. * doc/guix.texi (Sway window manager): Document this. Change-Id: Icf210aca4a9b44adc0baead7430637f6fcda17e5 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-09-05services: cuirass: Add more configuration fields.Ludovic Courtès
* gnu/services/cuirass.scm (<cuirass-configuration>)[parallel-evaluations] [evaluation-ttl, web-threads]: New fields. (cuirass-shepherd-service): Honor them. * doc/guix.texi (Continuous Integration): Document them. Change-Id: I33485b978d2a37ee93230b1d425731e6cb3b80e4
2025-09-04doc: Remove misplaced ‘guix refresh’ example.Ludovic Courtès
* doc/guix.texi (Invoking guix refresh): Remove broken and out-of-place ‘trytond-party’ example. Change-Id: Iab2413774eb611e7fab2519001f484ce29010599
2025-09-04doc: Restructure 'guix refresh' section.Hugo Buddelmeijer
Previously, there were options described in the running text (in particular --recursive), and vice-versa, there was normal text interleaved inbetween the options. Both hid information, as it was unclear where an option description would change into running text. Furthermore, tables were closed and opened arbitrarily, making the section hard to read. Can probably be improved further. * doc/guix.texi (Invoking guix refresh): Restructured text. Change-Id: I517d0dc43a9addbaccf5e5e8c9fadfa30fe378db Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-09-02docs: Fix module reference in guix-home-service-type.Gabriel Santos
* doc/guix.texi (Guix Services): Use (gnu services guix) module instead of the outdated (gnu home) module in the example. Closes #2369. Change-Id: I19eeeffbaeb150db68510c90b0f7c8ef23bdfeb6 Signed-off-by: Maxim Cournoyer <maxim@guixotic.coop>
2025-09-02nls: Update translations.Florian Pelz
* po/doc/guix-cookbook.zh_CN.po: New file. * po/doc/local.mk: Add 'zh_CN' cookbook. * po/packages/ru.po: New file. * po/packages/LINGUAS: Add 'ru'. * doc/local.mk: Add 'zh_CN' cookbook. * doc/htmlxref.cnf: Update URLs for cookbook. * doc/build.scm (%cookbook-languages): Add 'zh_CN'. * doc/guix-cookbook.texi (Top): Mention 'zh_CN' cookbook. Change-Id: Ic15114f01ee826a72060eebcbf1baf3bf619284f
2025-08-30services: hurd-vm: Support different hurd types.Yelninei
* gnu/services/virtualization.scm (sanitize-hurd-vm-configuration-type): New procedure. (hurd-vm-confiuration): Add type field. (hurd-vm-disk-image): Use it. * doc/guix.texi (hurd-vm-configuration): Document it. * gnu/tests/virtualization.scm (%childhurd64-os): New variable. (run-childhurd-test): Add the os a parameter. (%test-childhurd): Adjust accordingly. (%test-childhurd64): New system test. Change-Id: Ie1c55a9414657ced4bf8b4324527037f1a1f78f4 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2025-08-29services: cuirass: Increase default polling interval to 5mn.Ludovic Courtès
* gnu/services/cuirass.scm (<cuirass-configuration>)[interval]: Change to 300. * doc/guix.texi (Continuous Integration): Update accordingly and explain where it is used. Change-Id: I30e38ffe0d75cd1f5857b422b4fa5d05dd47a7e5
generated by cgit v1.3 (git 2.53.0) at 2026-06-03 20:30:24 +0000