manuals:distributions:guix

This is an old revision of the document!


GNU Guix System

GNU Guix System is a distribution based on Guix package manager. It allows one to declaratively configure the system and its services, a concept shared with NixOS. While NixOS uses the Nix language, Guix uses Guile Scheme. This page describes Guix specifics on vpsFree.cz's VPS.

Configuration

The VPS is created from a template which contains a minimal system with SSH. You can log in using a generated password or deploy your public key using vpsAdmin. The system can then be configured using guix system reconfigure. Since our VPS are containers, it is necessary to disable bootloader installation using option –no-bootloader.

System configuration is stored in directory /etc/config:

  • vpsadminos.scm contains configuration specific to our environment
  • system.scm loads vpsadminos.scm and is meant to be edited to configure the system
# guix pull
# guix system reconfigure --allow-downgrades --no-bootloader /etc/config/system.scm

Known issues

  • guix system reconfigure requires –allow-downgrades, why? Something is fishy with the channels.
  • halt (graceful shutdown) has been observed to sometimes hang, please report in case it's still a problem.
  • cgroups v1 are not mounted. cgroups do not seem to be needed by the base system, contact us in case it's a problem for some service or submit a patch to the template.
manuals/distributions/guix.1693337187.txt.gz · Last modified: 2023/08/29 19:26 by Aither