← Back to catalogue
Published

GNU Guix System

vr.tr.gnu-guix-system · thing-q19597382

Enable an agent to recognise GNU Guix System, assess the configuration and recoverability of an installation, and plan justified changes to its declared operating system.

Thing Registry Physical world and living systems PHY.OBJ

Bundle → Layer → Finding → Questions Filled

7 bundles · 13 layers · 17 findings · 30 questions

System identity Establish what qualifies as GNU Guix System and what represents a particular installation.

Distribution boundary

Separate the operating-system distribution from adjacent Guix facilities.

System ownership

Require evidence that Guix supplies the system configuration and lifecycle.

  1. What evidence establishes that this installation is GNU Guix System rather than another distribution running Guix? definition
  2. Which observed configurations belong to the system, Guix Home or personal package profiles? boundary

Installation lineage

Relate installation evidence to the registered distribution without creating a model for every machine.

Variant and target

Record the target environment and departures introduced by custom channels or system components.

  1. Which image, configuration repository and channel revisions establish this installation's origin? provenance
  2. Which custom components affect whether the installation should be described as stock GNU Guix System or a derivative? boundary
Declarative composition Capture the inputs and extension relationships that produce the intended operating system.

Configuration inputs

Identify the complete input boundary of the operating-system declaration.

Declaration completeness

Assess whether the retained declaration and supporting inputs explain the generated system.

  1. Which operating-system expression, imported modules, local files and invocation options produced this generation? provenance
  2. Which inputs depend on local paths, environment values or external resources that another builder would lack? boundary

Service extension

Connect Guix service declarations to generated configuration and runtime responsibilities.

Service effects

Trace how declared services contribute accounts, files, activation work and runtime services.

  1. Which service types and extensions supply each relevant account, configuration file and Shepherd service? definition
  2. What dependent configuration or runtime behaviour would change if this service declaration were modified? action
Build provenance and trust Connect a system result to software definitions, build inputs and accepted artifacts.

Channel pinning

Identify the precise Guix and additional-channel definitions used for a system.

Revision reconstruction

Require recoverable channel revisions and distinguish recorded inputs from demonstrated reproducibility.

  1. Which exact channel commits and authentication information accompanied the Guix used to build this system? provenance
  2. Can those revisions and the configuration inputs still be retrieved and evaluated with an appropriate Guix invocation? action

Artifact acceptance

Assess the provenance and trust basis of store items entering the system.

Substitutes and build evidence

Separate acceptance of signed substitutes from evidence that independent builds agree.

  1. Which system dependencies were built locally, obtained from substitutes or imported through another route? provenance
  2. Which keys authorise accepted substitutes, and what independent rebuild evidence exists for critical outputs? provenance
Generation lifecycle Assess system builds, activation and recovery through generations; the relevant command family is documented in the [GNU Guix Reference Manual](https://guix.gnu.org/manual/en/guix.pdf).

Build and activation

Track candidate, selected and running states across a proposed change.

Transition readiness

Establish evidence and authority for moving a candidate into service.

  1. Which generation is built, selected, booted and scheduled for the next boot? measurement
  2. Which changes require service intervention or reboot, and what validation must precede reconfiguration? action

Rollback boundary

Assess recovery generations together with data and access requirements.

Recoverable generation

Identify a usable recovery target without assuming that switching generations restores mutable state.

  1. Which retained generation has evidence of successful operation, and are its required store items and boot entry available? provenance
  2. Which database migrations, secrets or persistent files could prevent that generation from working after a rollback? boundary
  3. How can an authorised operator select the recovery generation if normal boot or remote access fails? action
Host fit and runtime Assess whether the declared Guix System can boot and deliver its intended services on the target.

Boot and hardware

Connect target hardware to declared kernel, firmware, storage and boot components.

Boot path fit

Assess the path from firmware to a mounted root filesystem and usable system.

  1. Do the declared kernel, firmware and initrd support the target's storage, network and other required devices? measurement
  2. Do bootloader targets, filesystem identifiers and mapped-device declarations match the intended installation? measurement

Runtime agreement

Compare generated service intent with observed behaviour.

Shepherd service health

Relate Shepherd observations and service-specific probes to the selected system configuration.

  1. Which expected Shepherd services are running, stopped or failing, and what do application-level probes show? measurement
  2. Which intervention belongs in the operating-system declaration, and which is a temporary runtime action? action
Persistent state and store retention Separate reproducible system artifacts from mutable information and recovery dependencies.

Mutable state

Identify data and secrets outside the recoverable system declaration.

State and secret boundary

Assess persistence, backup and secret provisioning independently of system generations.

  1. Which service data, home directories and machine-specific files require separate backup and restoration? boundary
  2. How are credentials provisioned without embedding sensitive contents in readable store artifacts or shared configuration? action

Store retention

Connect storage reclamation to profiles, generations and garbage-collection roots.

Collection consequences

Evaluate what can be reclaimed while retaining required rollback and rebuild options.

  1. Which profiles, generations and explicit garbage-collection roots retain the store items required for recovery? relation
  2. How much space could be reclaimed, and which recovery options would disappear after deleting generations and collecting unreferenced items? measurement
Evidence and external alignment What the world already says about this thing, gathered so the model can be checked against it.

Reported evidence

Findings from the breadth pass, kept separate from the structural claims.

Check these first

Recalled without web access and unsourced; every item is a lead to verify.

  1. Which of these check these first hold for the sense of GNU Guix System this model covers, and on what evidence? provenance

Standards and regulation

Recalled without web access and unsourced; every item is a lead to verify.

  1. Which of these standards and regulation hold for the sense of GNU Guix System this model covers, and on what evidence? provenance

Real-world use

Recalled without web access and unsourced; every item is a lead to verify.

  1. Which of these real-world use hold for the sense of GNU Guix System this model covers, and on what evidence? provenance

Failure modes and hazards

Recalled without web access and unsourced; every item is a lead to verify.

  1. Which of these failure modes and hazards hold for the sense of GNU Guix System this model covers, and on what evidence? provenance

Neighbouring kinds and how to tell them apart

Recalled without web access and unsourced; every item is a lead to verify.

  1. Which of these neighbouring kinds and how to tell them apart hold for the sense of GNU Guix System this model covers, and on what evidence? provenance

Classifiers Filled

Family
Thing Registry
Category
Physical world and living systems
Entry kind
thing
Plane
PHY
Domain
PHY.OBJ

What it is Filled

GNU Guix System is a GNU/Linux operating-system distribution that uses the GNU Guix package manager and declarative configurations written in Guile Scheme to manage software, services, and system generations, with support for transactional upgrades and rollbacks.

In scope

  • Identity of GNU Guix System and boundaries with the Guix package manager
  • Scheme operating-system declarations and their configuration dependencies
  • Channel revisions, store dependencies and build provenance
  • System generations, activation, boot selection and recovery
  • Declared services, hardware compatibility and persistent-state boundaries

Out of scope

  • GNU Guix used solely as a package manager on another distribution
  • Guix Home configurations and personal package profiles except their interfaces with the system
  • Physical computers, storage devices and network equipment
  • Application business logic and application data schemas
  • GNU Project governance and individual software-package models

Why it exists Filled

Enable an agent to recognise GNU Guix System, assess the configuration and recoverability of an installation, and plan justified changes to its declared operating system.

Distinguishing features Filled

  • Establish whether Guix manages the operating system itself; the presence of the guix command or /gnu/store alone does not establish GNU Guix System.
  • Look for a Guile Scheme operating-system declaration governing system composition, distinguishing it from NixOS configuration.
  • Check for system generations managed through guix system, distinguishing them from generations of a user's package profile.
  • Examine the GNU Shepherd service configuration and its relationship to Guix service declarations.
  • Check the kernel and added channels against the distribution's Linux-libre and free-software orientation, recording installation-specific departures.

What robots and AI may and may not do Filled

Must not

  • Change system configuration on machines it does not administer.
  • Disable security updates or roll back to vulnerable generations without the administrator's decision.
  • Distribute modified packages in breach of their free software licences.
  • Present it as supporting hardware or features it does not support.

Only with a human decision

  • Reconfiguring production systems or deleting old system generations.

May

  • Install, configure and update a Guix System machine the agent is authorized to administer.
  • Describe its declarative and reproducible design from official documentation.

Moral aspects Filled

  • Free software freedoms depend on honouring licences.
  • Administrative mistakes on servers affect everyone who relies on them.

Who is affected

  • System users
  • Administrators
  • Free software developers

Owners Filled

Steward

The administrator of each installation; the project maintains the distribution.

Links to other meta-models Filled

parent

  • Q89580282 - registry parent class

What else AI and robots need to interact with it Filled

Identity and identifiers required Filled

  • Vercy registry: vr.tr.gnu-guix-system
  • Wikidata: Q19597382 (https://www.wikidata.org/wiki/Q19597382)

Direct properties required Filled

  • System configuration origin: Operating-system declaration, repository revision and imported local modules
  • Guix channel identity: Channel names, repository URLs, commits and authentication introductions where applicable
  • Generation alignment: Built candidate, selected system generation, booted generation and next-boot selection
  • Execution target: Architecture and target; physical installation, virtual machine, container or image
  • Kernel and firmware composition: Declared kernel package, firmware packages and originating channels
  • Service agreement: Declared service extensions and observed Shepherd service status; aligned, divergent or unknown
  • Substitute trust: Configured substitute servers, authorised signing keys and applicable policy
  • Store capacity: Bytes available, bytes occupied and estimated reclaimable bytes at a recorded time
  • Persistent-state recovery coverage: Protected, partially protected, unprotected or unverified, per state location

Recognition required Filled

  • Not a physical object; seen as a Linux system configured by a Scheme file and managed with the guix command.

Capabilities and actions required Filled

  • Inspect a declaration and its channel inputs to identify the intended system.
  • Build a candidate system or suitable test image before activation.
  • Compare generations and assess the consequences of reconfiguration.
  • Inspect service composition and reconcile it with runtime observations.
  • Plan generation switching or rollback together with persistent-data recovery.
  • Assess retained generations and garbage-collection roots before reclaiming store space.

Hazards and failure modes required Filled

  • Configuration errors can leave a system unbootable until rolled back.
  • Missing proprietary drivers can leave some hardware unusable.

Standards and interfaces required Filled

  • ISO/IEC 9945, issued by the International Organization for Standardization and the International Electrotechnical Commission, specifies operating system interfaces relevant to its Unix-like software environment without establishing full distribution conformance.

Context of use required Filled

  • This operating system is used on computers where packages, services and system configuration are managed through declarative definitions.
  • It supports maintaining reproducible environments and returning to earlier system generations, although rollback does not necessarily restore application data.

Sources Filled

  1. Wikidata item Q19597382: GNU Guix System - identity and sense of the item
  2. Wikipedia: GNU Guix System - general description of the item

Open questions

  • Should the registry's PHY / PHY.OBJ assignment be corrected to represent an operating-system distribution, and does an existing world model already cover this concept?
  • Which Guix revision should anchor version-sensitive details of generation switching, activation and bootloader behaviour?
  • What evidence and terminology should distinguish GNU Guix System with custom channels from a separately identified derivative?
  • Which target architectures, hardware configurations and recovery paths have actually been tested for the installations this model will assess?
  • What reproducibility threshold is required: reconstructing declared inputs, obtaining an equivalent working system or independently reproducing identical build outputs?

Machine files

Provenance

thing registry research (pass 2) · unreviewed

Built from: models/things/publications/thing-q19597382/spec.json