summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2026-03-15Added instructions for deploying machine configurations.linode-image-docsDan Rostovtsev
2026-03-15Example config in documentation folderDan Rostovtsev
2026-03-15Updated working version of linode docs.Dan Rostovtsev
2026-03-14Added boot and SSH instructions after creating bootable guix os in linode.Dan Rostovtsev
2026-03-14Added first pass at guix installation for linode.Dan Rostovtsev
2026-03-10services: Generalize alsa-configuration.Liliana Marie Prikler
* gnu/packages/sound.scm (alsa-pcm-configuration, alsa-ctl-configuration): New configuration records. (serialize-alsa-pcm-configuration, serialize-alsa-ctl-configuration): New variables. (<alsa-configuration>): Remove alsa-plugins and pulseaudio?. Add default-pcm and default-ctl. Rename extra-options to options. (alsa-config-file): Adjust accordingly. (alsa-servcice-type): Add compose and extend. (<pulseaudio-configuration>): Add alsa-lib. (pulseaudio-alsa-configuration): New procedure. (pulseaudio-service-type): Extend alsa-servcice-type.
2026-03-09gnu: Add soju-service-type.Giacomo Leidi
* gnu/services/messaging.scm (%default-soju-shepherd-requirement): New variable. (soju-ssl-certificate): New configuration record. (soju-database): New configuration record. (soju-configuration): New configuration record. (serialize-soju-configuration,soju-activation,soju-accounts, soju-shepherd-services): New procedures. (soju-service-type): New service. (serialize-ngircd-configuration): Reformat. (pounce-configuration): Reformat. * doc/guix.texi: Document the new soju service. * gnu/tests/messaging.scm: Test the new soju service. Change-Id: I6223ecac1aaaab76bd75461851ffe4cec0678118
2026-03-08doc: Remove mention of python-toolchain.Sharlatan Hellseher
* doc/contributing.texi (Python Moduels): Drop mention of python-toolchain. * guix/build-system/pyproject.scm: Likewise. Fixes: guix/guix#5841 Change-Id: I39a1ec7ce6da2e5f3298323b36070c3e3b197669
2026-03-07gnu: home: dotfiles: Fix inclusion of directories having .git in their name.Giacomo Leidi
* gnu/home/services/dotfiles.scm (%home-dotfiles-excluded): Replace .git/.* with /.git/.* . * doc/guix.texi: Document it. Fixes https://codeberg.org/guix/guix/issues/6808 Change-Id: Ib6c824bb4bf5a5b3d6939807667c7961ce0cf6d2
2026-03-07gnu: Add tuned-service-type.Giacomo Leidi
* gnu/services/linux.scm (tuned-configuration,tuned-settings,tuned-ppd-settings): New configuration records. (tuned-file-systems,tuned-activation,tuned-shepherd-services, tuned-kernel-modules): New procedures. (tuned-service-type): New service type. * doc/guix.texi: Add service documentation. Change-Id: I6c8d54c23175c2ea133d99965641c548fb1d6452
2026-03-03services: readymedia: Allow relative paths to media directories.Sughosha
* gnu/services/upnp.scm (readymedia-activation): For home services, if the media directory paths are relative, create it in the user's home directory. * doc/guix.texi (Miscellaneous Services)[DLNA/UPnP Services]: Update doc. Change-Id: I39176320d6c33c56c5b80ad9e67e989ee41565da
2026-03-03doc: Refresh python documentation.Nicolas Graves
* doc/contributing.texi: Refresh python documentation (avoid uses of "we " and "you", remove the reference to pyproject-build-system as experimental, and adjust the setuptools situation comments). Merges: https://codeberg.org/guix/guix/pulls/6427 Change-Id: Idb065befc975063ad97e6bdafb724e50d6891cb5 Reviewed-by: Yan Abu Arab <yanabuarab@gmail.com> Reviewed-by: Maxim Cournoyer <maxim@guixotic.coop> Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
2026-03-02doc: Fix typo in home-readymedia-service-type example.chris0ax
* doc/guix.texi (Miscellaneous Home Services): Change readymedia-directory to readymedia-media-directory in home-readymedia-service-type example. Merges: https://codeberg.org/guix/guix/pulls/5496 Change-Id: Ica68a26bef7e960bbda769a1a04798d86bbe7d1e Reviewed-by: Sergey Trofimov <sarg@sarg.org.ru> Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
2026-03-01gnu: services: Add gunicorn-service-type.Fabio Natali
* gnu/services/web.scm (<gunicorn-configuration>, <gunicorn-app>): New records. (unix-socket?, unix-socket-path, gunicorn-activation, gunicorn-shepherd-services): New procedures. (gunicorn-service-type): New variable. * doc/guix.texi (Web Services): Document the new service. Co-authored-by: Arun Isaac <arunisaac@systemreboot.net> Change-Id: I3aa970422e6a5d31158b798b1061e6928ad2160b Signed-off-by: jgart <jgart@dismail.de>
2026-03-01doc: Fix typo.Florian Pelz
* doc/guix.texi (Package Transformation Options): Fix typo. Change-Id: I27186684db1355d9876ecc23e76f8bcc8cdbf9eb
2026-02-27doc: Refer to more online manuals at doc.guix.gnu.org.Ludovic Courtès
* doc/htmlxref.cnf: Add grub, inetutils, and recutils. Change-Id: Icaa85d59c64b5f1ff7d34fa3e368ee1f66054fcc
2026-02-25services: Support list of strings for oci-container-configuration's entrypoint.Giacomo Leidi
Dockerfile's ENTRYPOINT statement supports also a list of strings. This patch implements this behavior for oci-container-configuration. * oci/services/containers.scm (string-or-list-of-strings?): New procedure. (oci-container-configuration)[entrypoint]: Change field type to maybe-string-or-list-of-strings. (oci-container-configuration->options): Use it. * doc/guix.texi: Document it. Change-Id: I1c94dec79c9f4b2324225810a7926be251bfd795 Reviewed-by: Owen T. Heisler <writer@owenh.net> Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
2026-02-22gnu: home: dotfiles: Files not excluded when they should.Giacomo Leidi
* gnu/home/services/dotfiles.scm (%home-dotfiles-excluded): Match content of .git directories. (directory-contents): Match whole file-name instead of basename. * doc/guix.texi: Document it. Fixes <https://issues.guix.gnu.org/71217> Authored-by: Nicolas Odermatt-Lemay <nodermattlemay@gmail.com> Change-Id: I2929fe3318e1f9f0b552c891207524dea25389ed Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-22doc: Improve raid-device-mapping documentation.Hugo Buddelmeijer
* doc/guix.texi (Mapped Devices): Move examples into the mapping defvars. Add how to load kernel modules for raid. Add RAID cindex. Change-Id: If2d3f3c48940d2428b36bdd85d31c8288db35f3b Signed-off-by: Ludovic Courtès <ludo@gnu.org> Modified-by: Ludovic Courtès <ludo@gnu.org> Merges: #6512
2026-02-22doc: Mention online documentation.Ludovic Courtès
* doc/guix.texi (Documentation): Mention the online manual and doc.guix.gnu.org. Change-Id: I5abdd85fa2166890323f99a99c30136400791bdd Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #6563
2026-02-22services: readymedia: Fix configurations.Sughosha
* gnu/services/upnp.scm (%readymedia-default-log-directory): Remove variable. (%readymedia-default-log-file): New procedure. (%readymedia-default-cache-directory): Turn it into a procedure. (<readymedia-configuration>)[log-directory]: Remove field. [log-file]: New field. [cache-directory]: Set to %readymedia-default-cache-directory. (readymedia-configuration->config-file): Remove "user" and "log_dir" fields. (readymedia-shepherd-service)[modules]: Add (shepherd support). [start]: Do not map the log-directory. For home services, do not wrap the program with least-authority-wrapper. (readymedia-activation): Do not create the log-directory. * gnu/home/services/upnp.scm (%readymedia-cache-file, %readymedia-cache-path, %readymedia-log-path): Remove variables. (run-readymedia-test): Use the procedures properly. Do not test the log directory. Test the log file. * doc/guix.texi (Miscellaneous Services)[DLNA/UPnP Services]: Update doc. Change-Id: I97d84b5287c374ddb26a495f20a36f986b0c142d Signed-off-by: Giacomo Leidi <therewasa@fishinthecalculator.me>
2026-02-10gexp: Add 'delayed-object'.David Elsing
* guix/gexp.scm (<delayed-object>): New record type. (delayed-object): New macro. (delayed-object-compiler): New gexp compiler. * tests/gexp.scm ("delayed-object"): New test. * doc/guix.texi (G-Expressions): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-02-10doc: Refer to on-line manuals at doc.guix.gnu.org.Ludovic Courtès
* doc/htmlxref.cnf: Add entries for 20 manuals at doc.guix.gnu.org. Change-Id: I28ff7b00d024214bf22b6ae06bc873528a0c7440 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #6271
2026-02-10services: Fix logging for jami-service-type.Maxim Cournoyer
Its default behavior changed and it no longer logs to syslog by default; update to log to /var/log/jami.log instead. * gnu/services/telephony.scm (jami-configuration->command-line-arguments): Drop /dev/log mapping. Add /var/log/jami.log mapping. Always add --console argument. (jami-shepherd-services): Conditionally add #:log-file argument; simplify usernames logic a bit. * gnu/services/telephony.scm (jami-configuration): Update doc. * doc/guix.texi (Telephony Services): Likewise. Change-Id: Ia2819866c84db4cba92fad52dfd0a74acdc887fc
2026-02-09gnu: services: Add xandikos-service-type.Wilko Meyer
* gnu/services/dav.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add file. * doc/guix.texi (DAV Services): Document the service. Change-Id: I5345efd579f9e527eb8798397b52bf1b9b4cab56
2026-02-08services: web: Add go-webdav.Sören Tempel
* gnu/services/web.scm (go-webdav-service-type): New service. (go-webdav-account-service): New variable. (go-webdav-shepherd-service): New procedures. * gnu/tests/web.scm (%test-go-webdav): Add tests for the service. * doc/guix.texi (Web Services): Document it. Signed-off-by: Danny Milosavljevic <dannym@friendly-machines.com>
2026-02-08import/elpa: Add GNU-devel repository.Maxim Cournoyer
* guix/import/elpa.scm (%elpa-archives): Register GNU-devel archive. * doc/guix.texi (Invoking guix import): Document it. Change-Id: If036334477be7537ff70a62d4900427d74bc05db
2026-02-06services: static-networking: Add ‘scope’ field to <network-route>.Ludovic Courtès
* gnu/services/base.scm (assert-network-route-scope): New procedure. (<network-route>)[scope]: New field. (network-set-up/linux)[route-scope->constant]: New procedure. Use it to pass #:scope to ‘route-add’. * doc/guix.texi (Networking Setup): Document it. Fixes: guix/guix#4175 Reported-by: Christopher Baines <mail@cbaines.net> Change-Id: I24399eca6e691d63fa3d01be564060a3d693d650 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #5507
2026-02-03doc: Document “standard” pull requests and AGit.Ludovic Courtès
* doc/contributing.texi (Submitting Patches): Document “standard” pull requests and AGit. Merges guix/guix!5840 Change-Id: I8fe93e4dde0b9543f3bd99c66cf1fdb6ba69c449 Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-03doc: Remove “Debbugs Usertags” section.Ludovic Courtès
* doc/contributing.texi (Debbugs Usertags): Remove. Merges guix/guix!5840 Change-Id: If550e31918c495ed24578fcbaaa179eb36521687 Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-03doc: Update Debbugs deprecation warnings.Ludovic Courtès
* doc/contributing.texi (The Issue Tracker): Update deprecation notice. (Debbugs User Interfaces): Likewise. Merges guix/guix!5840 Change-Id: Ic5c1bddddbb8c53b031d52887f57372759badf8b Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-03doc: Remove “Sending a Patch Series” section.Ludovic Courtès
* doc/contributing.texi (Sending a Patch Series): Remove. Merges guix/guix!5840 Change-Id: I8f15c4385b24cecc6a8f1bd13c2065d2a267e5b1 Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-03doc: Contributions are now made on Codeberg.Ludovic Courtès
* doc/contributing.texi (Submitting Patches): Document Codeberg pull requests as the only method. Mention guix-patches@gnu.org in a footnote. Remove paragraphs about of ‘git send-email’ and the associated workflow. Merges guix/guix!5840 Reported-by: Nick Blumenauer <nicknb@posteo.com> Change-Id: Ifbd46665a14a83f014ddff4234cc69bf93c3a8d1 Signed-off-by: Cayetano Santos <csantosb@inventati.org>
2026-02-02home: services: ssh: Add support for known_hosts2 file.Oleg Pykhalov
This commit adds a new 'known-hosts2' field to the OpenSSH home service configuration, enabling a hybrid approach to SSH host key management. * gnu/home/services/ssh.scm (<home-openssh-configuration>)[known-hosts2]: New field. (openssh-configuration-files): Generate ~/.ssh/known_hosts2 when specified. * doc/guix.texi (Secure Shell): Document new 'known-hosts2' field. Change-Id: I1d314706eaf6af9547833020abe857f4d8c44b86
2026-01-27serialization: Use ‘bytevector-slice’ from Guile >= 3.0.9.Ludovic Courtès
* guix/serialization.scm (sub-bytevector): Remove. (read-byte-string): Use ‘bytevector-slice’. * configure.ac: Require Guile 3.0.9. * doc/contributing.texi (Requirements): Adjust accordingly. Change-Id: I7aa11a2182530ea5131be591db03b17efb6847a4 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #4495
2026-01-27services: Add endlessh-service-type.Clombrong
* docs/guix.texi: Document EndleSSH service and configuration. * gnu/services/ssh.scm: New service. * gnu/services/ssh.scm: Define shepherd service. Merges: https://codeberg.org/guix/guix/pulls/5910 Co-Authored-By: Giacomo Leidi <therewasa@fishinthecalculator.me> Change-Id: Ief4520b536276b88f2e5027ef0897bf84b2835df Signed-off-by: Giacomo Leidi <therewasa@fishinthecalculator.me>
2026-01-27doc: Fix typo.Maxim Cournoyer
* doc/guix.texi (Invoking guix import): Fix typo. Change-Id: I4d9234ac3c4d83f64d36e7aedf4c67e9eaf79167
2026-01-26doc: Fix hello package example.Charles Roelli
* doc/guix.texi (Defining Packages): Fix package example. Change-Id: Ib3bf14f50a938de569b7eb1927ec18d9ee5d1e5c Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #5838
2026-01-26doc: cookbook: Don’t insist on mounting home directories on the head node.Ludovic Courtès
* doc/guix-cookbook.texi (Setting Up a Head Node): State that mounting home directories on the head node is “optional”. Change-Id: Id60b54d463f5422f71a71607cd71ed347a98865e Merges: #5890
2026-01-26doc: cookbook: Recommend systemd timer for ‘guix gc’.Ludovic Courtès
* doc/guix-cookbook.texi (Setting Up a Head Node): Give instructions for the systemd timer rather than ‘crontab’. Change-Id: I063ad0ea694500a67553d66d37ae354b9c078a65
2026-01-26doc: cookbook: Update for unprivileged guix-daemon execution.Ludovic Courtès
* doc/guix-cookbook.texi (Setting Up a Head Node): Add note about unprivileged guix-daemon. Remove ‘--build-users-group=guixbuild’ flag from ‘.service’ snippets. Mention “systemd timer” next to “crontab entry”. Change-Id: I72ac59d3ce8a5572dbeb8cb4c7764a8478f6e1ee
2026-01-25transformations: Add ‘--amd-gpu’ transformation option.Ludovic Courtès
* guix/transformations.scm (split-on-commas): New procedure, moved from… (transform-package-toolchain): … here. (package-amd-gpu-specialization, transform-package-amd-gpu-targets): New procedures. (%transformations, %options): Add ‘amd-gpu’. * tests/transformations.scm ("options->transformations, amd-gpu") ("options->transformations, amd-gpu, not applicable") ("options->transformations, amd-gpu, missing clang-rocm input") ("options->transformations, amd-gpu, wrong GPU"): New tests. * doc/guix.texi (Package Transformation Options): Document it. Change-Id: I56bf0dffbf12bc08cf6318fe56952473b395c303 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #5583 Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-25doc: Add an URL link.Hartmut Goebel
* doc/guix.texi (Services)[Telephony Services]{Jami}: Add link to the Jami project home-page. Change-Id: If8e5ad61f9f36c0403e74d6926e89eb463bb009b Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-25doc: Small rewording.Hartmut Goebel
* doc/guix.texi (Services)[Continuous Integration]: Add quotes to mark terms as such. Fix typo. Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-25doc: Fix an URL.Hartmut Goebel
* doc/guix.texi (Services)[Desktop Services]: Fix an URL. Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-25gnu: texlive: Deprecate in favor of texlive-scheme-full.Andreas Enge
* gnu/packages/texlive.scm (%texlive-date, %texlive-year, texlive-extra-src, texlive-texmf-src, texlivebin, texlivetexmf): Delete variables. (texlive): Redefine as texlive-scheme-full. * gnu/packages/books.scm: Remove module inclusion. * doc/guix.texi: Remove documentation for monolithic texlive. Change-Id: I23837ca29cbbc080833be122972dcfe31c0fd1bb Signed-off-by: Rutherther <rutherther@ditigal.xyz>
2026-01-22doc: Use devel url on master.Rutherther
To prevent redirection to the versioned maual, use devel on master branch. * doc/htmlxref.cnf: Point GUIX to devel manual. Change-Id: I6b2bf3b78ca5815ff49e6ebe50bc12383e64a7fd
2026-01-22Merge branch 'version-1.5.0'Rutherther
Change-Id: Id73c0c74600a3da3373b3a37236b505af65bfe31
2026-01-19doc: Use versioned URL for references to translated Guix manuals.Ludovic Courtès
Partly addresses guix/guix#5725. * doc/htmlxref.cnf (GUIX): Add /1.5.0. Change-Id: I49ef15c00ca45b83a48ba0d1366b79a108e1e1a8 Signed-off-by: Rutherther <rutherther@ditigal.xyz> Merges: #5754
2026-01-19import: nuget: Add tests and documentation.Danny Milosavljevic
* guix/import/nuget.scm: Prevent optimizing small functions away completely. * tests/import/nuget.scm: New file. * doc/guix.texi (nuget): Document it. * Makefile.am (SCM_TESTS): Add reference to it. Fixes: guix/guix#5483 Change-Id: Id58932fe404a11a03e61a91d3b6177b39548f1bc