summaryrefslogtreecommitdiff
path: root/doc/guix.texi
AgeCommit message (Collapse)Author
2026-04-07doc: Fix documentation of the name service switch.Maxim Cournoyer
The previously referenced `nscd-service' procedure no longer exists. * doc/guix.texi (Name Service Switch): Adjust to refer to nscd-service-type and its nscd-configuration configuration record. Change-Id: Ib2b5ef69facf3489626782ad9dbd927a27c04084
2026-03-29doc: Add bcachefs to supported file systems footnote.Tobias Geerinckx-Rice
* doc/guix.texi (Keyboard Layout and Networking and Partitioning): Mention bcachefs as supported, provided you load the module. Change-Id: Iaadea6b2aabda2b803e1053b6d6195ad186d2e5c
2026-04-04services: Add gardenhostd-service-type.Noé Lopez
* gnu/services/desktop.scm (gardenhostd-service-type) (gardenhostd-configuration): New variables. * doc/guix.texi (Desktop Services): Document it. Change-Id: Ied926c34b620cc8032a0b121c7419644746e2ce9 Signed-off-by: Liliana Marie Prikler <liliana.prikler@gmail.com>
2026-04-02doc: Version Control Services: Fix Fossil example.Nguyễn Gia Phong
In the Fossil service example, correct the field name for list-repositories? and set https? to #t. * doc/guix.texi (Version Control Services): Fix the example for fossil-service-type. Change-Id: Ib1c1ba57d8f438a51e8bb7b6e97c57785685e110 Reviewed-by: Noé Lopez <noelopez@free.fr>
2026-04-02services: cat-avatar-generator: Fix default cache directory.Evgeny Pisemsky
* gnu/services/web.scm (cat-avatar-generator-service): Append slash to default cache directory. * doc/guix.texi (PHP-FPM)<cat-avatar-generator-service>: Likewise. Mention requirements. Change-Id: Idd46deca135bf37133b46bee3ba535d9bedf9258 Merges: https://codeberg.org/guix/guix/pulls/5189 Reviewed-by: Yan Abu Arab <yanabuarab@gmail.com> Signed-off-by: Nguyễn Gia Phong <cnx@loang.net>
2026-03-29gnu: Add home-jellyfin-mpv-shim-service-type.Ian Eure
* gnu/home/services/media.scm (home-jellyfin-mpv-shim-service-type): New variable. * doc/guix.texi (Jellyfin Services): New section. * doc/guix.texi (Kodi Services): Add subheading. Change-Id: I037ab0602214fdaa1b032be51ff98ecf6b7ee16c
2026-03-29gnu: Add collectd-service-type.Ian Eure
* gnu/services/monitoring.scm: (collectd-plugin-generic, collectd-plugin-generic?, collectd-plugin-generic-load-plugin?, collectd-plugin-generic-name, collectd-plugin-generic-options, collectd-plugin-python, collectd-plugin-python?, collectd-plugin-python-load-plugin?, collectd-plugin-python-type-databases, collectd-plugin-python-type-packages, collectd-plugin-python-module-paths, collectd-plugin-python-log-traces?, collectd-plugin-python-log-interactive?, collectd-plugin-python-import, collectd-plugin-python-module, collectd-plugin?, %collectd-default-type-database, %collectd-pid-file, collectd-configuration, collectd-configuration?, collectd-configuration-collectd, collectd-configuration-base-directory, collectd-configuration-auto-load-plugin?, collectd-configuration-collect-internal-stats?, collectd-configuration-type-databases, collectd-configuration-interval, collectd-configuration-max-read-interval, collectd-configuration-timeout, collectd-configuration-read-threads, collectd-configuration-write-threads, collectd-configuration-write-queue-limit-high, collectd-configuration-write-queue-limit-low, collectd-configuration-host-name, collectd-configuration-fully-qualified-domain-name-lookup?, collectd-configuration-plugins, collectd-service-type): New variable. * doc/guix.texi (Monitoring Services): Document it. Change-Id: I18d581292979e85603e679b9441be3eeb1856949
2026-03-29services: web: Add sogogi service.Sören Tempel
* gnu/services/web.scm (sogogi-service-type): New services. (sogogi-serialize-section, sogogi-serialize-field) (sogogi-serialize-string, sogogi-serialize-list-of-strings) (sogogi-serialize-sogogi-user, sogogi-serialize-sogogi-location) (sogogi-serialize-list-of-sogogi-user): New procedures. (sogogi-user, sogogi-location) (sogogi-configuration): New record types. (sogogi-account-service): New variable. (sogogi-config-file, sogogi-shepherd-service): New procedures. * gnu/tests/web.scm (%test-sogogi): Add tests for the service. * doc/guix.texi (Web Services): Document it. Change-Id: I5cc6dd84d6c7c8d5d13b685853b19c5d433ed7e5
2026-03-28doc: Document home-activation-service-type extension.Noé Lopez
* doc/guix.texi (Essential Home Services): Document home-activation-service-type extension. Merges: https://codeberg.org/guix/guix/pulls/7531 Change-Id: I2f27db86b138ab03ebca866b4a8be51c367b375c Reviewed-by: jgart <jgart@dismail.de> Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
2026-03-25doc: Link to gexp research paper.Ludovic Courtès
* doc/guix.texi (G-Expressions): Add reference to the 2017 GPCE paper. Change-Id: I47f9357ee2715640e8ceb1f5d286d98bf6c55abc Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #7288
2026-03-25doc: Add ‘with-imported-modules’ caveat.Ludovic Courtès
* doc/guix.texi (G-Expressions): Document caveat under ‘with-imported-modules’. Change-Id: I9ee5452c7d776647961b282a0e6cefece165b00b Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-03-21gnu: home: services: Add home-git-annex-assistant-service-typeYarl Baudig
* gnu/home/services/git-annex-assistant.scm: New file. * gnu/local/mk (GNU_SYSTEM_MODULES): Register it. * doc/guix.texi (Miscellaneous Services): Document it. Change-Id: I9ca75210dfe7f6d2d81b9eb8919d6eb34c7bb002 Signed-off-by: Ian Eure <ian@retrospec.tv>
2026-03-20records: Let thunked fields refer to their inherited value.Ludovic Courtès
* guix/records.scm (make-syntactic-constructor)[field-index]: New procedure. [wrap-field-value]: Add optional argument ‘parent’. When it is true, bind F to the inherited field value. [field-bindings/inheritance]: New procedure. Use it. * tests/records.scm ("define-record-type* & thunked & no inherited value") ("define-record-type* & thunked & inherited value") ("define-record-type* & thunked & inherited value & this-record"): New tests. * doc/guix.texi (Defining Package Variants): Update ‘modify-inputs’ example to refer to ‘inputs’. (Writing Manifests): Likewise. * doc/guix-cookbook.texi (Package Variants): Likewise for ‘substitute-keyword-arguments’. Fixes: https://issues.guix.gnu.org/50335 Change-Id: If4e18155ce203637ff9e116ee8098f8997bfebe2
2026-03-19services: dbus: Add rtkit service.陈功
* gnu/services/dbus.scm (rtkit-service-type): New variable. (rtkit-configuration): New record. Change-Id: I5078cb5032824c7799e7d26962911bbc67527562 Signed-off-by: Liliana Marie Prikler <liliana.prikler@gmail.com>
2026-03-18doc: Fix %childhurd-os example and memory-size documentation.Hugo Buddelmeijer
* doc/guix.texi (Virtualization Services): Fix %childhurd-os example and memory-size documentation. Change-Id: I5537eda4d0181e88229d836db522775494fc3d69 Signed-off-by: Maxim Cournoyer <maxim@guixotic.coop>
2026-03-14doc: Add references to “The Perfect Setup”.Ludovic Courtès
* doc/guix.texi (Defining Packages, Using the Configuration System): Add cross reference to “The Perfect Setup”. * doc/guix-cookbook.texi (A Scheme Crash Course): Likewise. Change-Id: If62960ffc01aadf9143b3816f4702f30b8052b90 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-03-11doc: Version Control Services: Generalize introduction.Nguyễn Gia Phong
* doc/guix.texi (Version Control Services): Update description to not be Git-exclusive. Update instroduction to mention Fossil in addition to Git. Add anchor points to navigate to individual services from the introduction. Change-Id: I3af870a80fcf249bed97b0d29370f71ff00a9e73 Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #4354
2026-03-11services: Add fossil-service-type.Nguyễn Gia Phong
* gnu/services/version-control.scm (fossil-service-type, fossil-configuration): New public variables. * gnu/tests/version-control.scm (%test-fossil): Add system tests. * doc/guix.texi (Version Control Services): Add Fossil documentation. Change-Id: I84e09fe8c11e161ed7c4bdba42b0ae38ef4c2096 Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2026-03-11services: Add and use shepherd-signal-action.Yelninei
* gnu/services/shepherd.scm (shepherd-signal-action): New procedure. * gnu/services/audio.scm (mpd-shepherd-service): Use it for actions. * gnu/services/base.scm (syslog-shepherd-service): * gnu/services/base.scm (dnsmasq-shepherd-service): * gnu/services/file-sharing.scm (transmission-daemon-shepherd-service): * gnu/services/monitoring.scm (vnstat-shepherd-service): * gnu/services/mail.scm (rspamd-shepherd-service): * doc/guix.texi (shepherd-signal-action): Document it. Change-Id: Ief5e00c7d430ec4aa28c3ef11d0ef9897793b45f Signed-off-by: Ludovic Courtès <ludo@gnu.org> Merges: #6097
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-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-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-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-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-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-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-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-22Merge branch 'version-1.5.0'Rutherther
Change-Id: Id73c0c74600a3da3373b3a37236b505af65bfe31
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
2026-01-19doc: Use markup for commands in “Upgrading Guix”.Ludovic Courtès
This is a followup to d5cf3b5defa8e224194ac0b195eb07fcb9d27a02. * doc/guix.texi (Upgrading Guix): Use markup for commands. Change-Id: I0b751ddc7f0e8e57813be23c809c23ade1e6cbd1 Signed-off-by: Rutherther <rutherther@ditigal.xyz> Merges: #5724
generated by cgit v1.3 (git 2.53.0) at 2026-05-28 09:48:46 +0000