guix-installer/README.md

System Crafters Guix Installer

This repository runs automated CI builds to produce a GNU Guix installation image using the full Linux kernel from the Nonguix channel. If you are using a modern laptop or hardware that is incompatible with the Linux Libre kernel, this installer image is for you!

Table of Contents :toc:noexport:

• System Crafters Guix Installer
  • Instructions
  • Attributions
  • License

Instructions

1. Download a recently built .iso from this repo's release page
2. Flash the .iso file into a USB stick with at least 3Gb.

Flashing the ISO

As stated in step #2 at Instructions, you will need to flash the .iso file into a USB stick.

[*]nix:

You should only need the dd utility (coreutils):

• dd status=progress if=guix-installerYYYYMMDDHHMM.iso of=/dev/foo
  • where guix-installerYYYYMMDDHHMM.iso is the name of the downloaded .iso image and foo the name of the targeted device to flash the image.

For the sake of providing an example, here's the full command:

`dd status=progress if=guix-installer-202106150234.iso of=/dev/sdb`

NOTE #1: You can list your devices with lsblk.

NOTE #2: If dd won't work for some reason, refer to the Windows.

Windows:

• balenaEtcher is a great cross-platform FOSS utility for flashing GNU/Linux images.
• If the above doesn't work, you might give Rufus a look.

Attributions

• @anntnzrb for providing the starting point for the CI configuration.
• @daviwil for releasing the finished CI configuration and getting everything up and running.
• The System Crafters' community.

License

The code in this repository is licensed under the GNU General Public License v3.