Skip to content

Latest commit

 

History

History
70 lines (49 loc) · 2.37 KB

README.md

File metadata and controls

70 lines (49 loc) · 2.37 KB

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

  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, 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.