e64463773d | ||
---|---|---|
.github/workflows | ||
.gitignore | ||
LICENSE.txt | ||
README.md | ||
build-iso.sh | ||
installer.scm |
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!
You may take a look at the image configuration and the build workflow to be sure that we aren't adding anything malicious to these builds!
A new .iso
image is produced at least once a week, sometimes more often if
we're making improvements to the configuration.
Table of Contents
Instructions
- Download a recently built
.iso
from this repo's release page - Flash the
.iso
file into a USB stick with at least3Gb
.
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 andfoo
the name of the targeted device to flash the image.
- where
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, refer to the Windows section.
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.