---

11 System Configuration

Guix System supports a consistent whole-system configuration mechanism. By that we mean that all aspects of the global system configuration—such as the available system services, timezone and locale settings, user accounts—are declared in a single place. Such a system configuration can be instantiated—i.e., effected.

One of the advantages of putting all the system configuration under the control of Guix is that it supports transactional system upgrades, and makes it possible to roll back to a previous system instantiation, should something go wrong with the new one (see Features). Another advantage is that it makes it easy to replicate the exact same configuration across different machines, or at different points in time, without having to resort to additional administration tools layered on top of the own tools of the system.

This section describes this mechanism. First we focus on the system administrator’s viewpoint—explaining how the system is configured and instantiated. Then we show how this mechanism can be extended, for instance to support new system services.

• Getting Started
• Using the Configuration System
• operating-system Reference
• File Systems
• Mapped Devices
• Swap Space
• User Accounts
• Keyboard Layout
• Locales
• Services
• Privileged Programs
• X.509 Certificates
• Name Service Switch
• Initial RAM Disk
• Bootloader Configuration
• Invoking guix system
• Invoking guix deploy
• Running Guix in a Virtual Machine
• Defining Services