This repository contains setup and management instructions for a Guix North American Build Farm.
Go to file
2024-09-27 17:55:21 -04:00
.guix/guix-na/config balg02: Add guix-north-america as a cuirass channel spec 2024-07-22 21:00:46 -04:00
.pubkeys cuirass.genenetwork.org.pub: Add guix-daemon signing key 2024-06-04 22:28:37 -04:00
docs Update documentation 2024-09-27 17:37:13 -04:00
.gitignore Initial setup (not yet bootstrapped or thoroughly tested) 2024-03-12 00:15:19 -04:00
.guix-authorizations Add rekahsoft-ed25519 key 2024-07-22 18:31:45 -04:00
.guix-channel Make this repository a authenticated Guix channel 2024-03-18 19:29:20 -04:00
channels.scm channels.scm: Update guix channel 2024-09-27 17:55:21 -04:00
news.txt news: Add entry about this authenticated channel 2024-03-18 19:31:40 -04:00
README.org Update documentation 2024-09-27 17:37:13 -04:00

Guix North America

This repository contains setup and management instructions for a Guix North American Build Farm.

Using Substitutes from cuirass.genenetwork.org

On Guix System

If you're using Guix System, you can use the cuirass.genenetwork.org substitute server completing the following:

  1. Add https://cuirass.genenetwork.org to the list of substitute servers (using the substitute-urls field of guix-configuration passed to the guix-daemon service).
  2. Adjust guix-daemon ACLs to include the following public key (using the authorized-keys field of guix-configuration passed to the guix-daemon service).

    (public-key
     (ecc
      (curve Ed25519)
      (q #9578AD6CDB23BA51F9C4185D5D5A32A7EEB47ACDD55F1CCB8CEE4E0570FBF961#)
      )
    )

    In the future, we hope to work with Guix maintainers to include this substitute server as one of the provided Guix System defaults.

On Foreign Distributions

When using Guix on a foreign distribution, you'll need to do the following to enable substitutes from cuirass.genenetwork.org:

  1. Add the public key (provided above) for cuirass.genenetwork.org to the guix-daemon ACLs.

      sudo guix archive --authorize < cuirass.genenetwork.org.pub
  2. Add the substitute url using the --substitute-urls option to guix-daemon. Assuming your foreign distribution uses systemd, this can be done using the following.

      sudo systemctl edit --full guix-daemon

    If you want to just use ci.guix.gnu.org, or cuirass.genenetwork.org for that matter, you'll need to adjust the substitute URLs configuration for the guix-daemon to just refer to the substitute servers you want to use. Once edited and saved, restart the guix daemon.

      sudo systemctl restart guix-daemon.service

Reference

Intial Setup Instructions
Details the initial setup of a genenetwork.org sponsored, single node build farm.
Administration of cuirass.genenetwork.org
details maintenance and administration of cuirass.genenetwork.org