Skip to content

Latest commit

 

History

History
403 lines (286 loc) · 19.4 KB

install-with-linuxloops.md

File metadata and controls

403 lines (286 loc) · 19.4 KB
Raw

License Issues Discord

Logo

Install Brunch with Linuxloops

Introduction

Linuxloops is a general purpose linux distro installer that also supports brunch and is available at: https://github.com/sebanc/linuxloops
Linuxloops will perform automatically most of the brunch install steps (notably downloading brunch, downloading the ChromeOS recovery image, installing build dependencies and running the install script).

Install from Linux

Install Brunch to a USB drive

Requirements

  • x86_64 based computer with UEFI boot support
  • Root access.
  • 8 GB available in your home directory.
  • Target USB must be 16 GB minimum.

Install process

  1. Identify the recovery suitable for your CPU:

Intel
  8th gen & 9th gen: "shyvana" for Intel / "bobba" for Celeron.
  10th gen: "jinlon".
  11th gen & above: "voxel".

AMD
  Ryzen: "gumboz".

  1. Install the PyQtWebEngine package for your distribution:
  • Debian / Ubuntu derivatives:
        Debian 12 / Ubuntu 24.04 and above: sudo apt install python3-venv python3-pyqt6.qtwebengine
        Older Debian / Ubuntu versions: sudo apt install python3-venv python3-pyqt5.qtwebengine
  • Arch-based distributions: sudo pacman -Syu python-pyqt6-webengine
  • RHEL-based distributions: sudo dnf install python3-pyqt6-webengine
  • OpenSUSE: sudo zypper in python3-PyQt6-WebEngine
  • Gentoo: sudo emerge dev-python/PyQt6-WebEngine
  • Void: sudo xbps-install python3-pyqt6-webengine python3-pyqt6-gui python3-pyqt6-widgets python3-pyqt6-network python3-pyqt6-webchannel python3-pyqt6-printsupport
  • NixOS: No package to install (python3Packages.pyqt6-webengine will be installed by linuxloops in nix-shell environment)
  1. Download the linuxloops script.

curl -L https://raw.githubusercontent.com/sebanc/linuxloops/main/linuxloops -O --create-dirs --output-dir ~/bin

  1. Launch the linuxloops script and follow the GUI installer selecting "Brunch" as the distro and the recovery compatible with your CPU as the environment.

bash ${HOME}/bin/linuxloops

  1. Once the install process is finished, reboot your computer and select your USB drive as boot device.

  2. (secure boot enabled) A blue screen saying Verification failed: (15) Access Denied may appear upon boot.

  • To enroll the key directly from a USB, select OK -> Enroll key from disk -> EFI-SYSTEM -> brunch.der -> Continue and reboot.

Next Steps

It is normal for the first boot to take a very long time, please be patient.

Install Brunch to a HDD/SSD

Requirements

  • x86_64 based computer with UEFI boot support
  • Root access.
  • 8 GB available in your home directory.
  • A USB drive that must be 16 GB minimum.
  • A HDD/SSD drive that must also be 16 GB minimum.

Install process

  1. Make a Brunch USB flashdrive using the above "Install Brunch to a USB drive" guide.

  2. Boot the ChromeOS USB drive, and switch to the TTY2 terminal with Ctrl + Alt + F2, then login as chronos.

  3. Before continuing, you will need to know what disk you want to install to. Be absolutely sure before you continue, this installation will erase everything on that disk, including other partitions. The disk must be at least 16 GB, or the installation will fail. There are several ways to determine which disk is your target, in this example we will use lsblk.

lsblk -e7

  1. Once you've determined your target disk, you're ready to install Brunch.
  • Replace disk in the below command with your target disk. (Such as sdb, mmcblk0 or nvme0n1 for example)

sudo chromeos-install -dst /dev/disk

The script will ask for confirmation. If you're ready to install, type yes into the prompt.

  1. Reboot your computer and select your HDD/SDD in the boot menu.

Next Steps

It is normal for the first boot to take a very long time, please be patient.

Install Brunch as a disk image (dualboot)

Requirements

  • x86_64 based computer with UEFI boot support
  • Root access.
  • 8 GB available in your home directory.
  • An unencrypted partition with 14 GB available (in ext4, btrfs, ntfs or exfat format).
  • GRUB as bootloader.

Install process

  1. Identify the recovery suitable for your CPU:

Intel
  8th gen & 9th gen: "shyvana" for Intel / "bobba" for Celeron.
  10th gen: "jinlon".
  11th gen & above: "voxel".

AMD
  Ryzen: "gumboz".

  1. Install the PyQtWebEngine package for your distribution:
  • Debian / Ubuntu derivatives:
        Debian 12 / Ubuntu 24.04 and above: sudo apt install python3-venv python3-pyqt6.qtwebengine
        Older Debian / Ubuntu versions: sudo apt install python3-venv python3-pyqt5.qtwebengine
  • Arch-based distributions: sudo pacman -Syu python-pyqt6-webengine
  • RHEL-based distributions: sudo dnf install python3-pyqt6-webengine
  • OpenSUSE: sudo zypper in python3-PyQt6-WebEngine
  • Gentoo: sudo emerge dev-python/PyQt6-WebEngine
  • Void: sudo xbps-install python3-pyqt6-webengine python3-pyqt6-gui python3-pyqt6-widgets python3-pyqt6-network python3-pyqt6-webchannel python3-pyqt6-printsupport
  • NixOS: No package to install (python3Packages.pyqt6-webengine will be installed by linuxloops in nix-shell environment)
  1. Download the linuxloops script.

curl -L https://raw.githubusercontent.com/sebanc/linuxloops/main/linuxloops -O --create-dirs --output-dir ~/bin

  1. Launch the linuxloops script and follow the GUI installer selecting "Brunch" as the distro and the recovery compatible with your CPU as the environment.

bash ${HOME}/bin/linuxloops

Choose "image" at the install type prompt, place the image on an unencrypted parition and define the disk image size.

  1. At the end of the install process, the GUI installer will provide you with a command that will generate the needed GRUB configuration. Run it in a terminal.

  2. (secure boot enabled) Once install is finished, run:

sudo mokutil --import <image_path>/<image_name>.img.der

  1. Reboot your computer and launch Brunch from GRUB.

Next Steps

It is normal for the first boot to take a very long time, please be patient.

Install from Windows

Install Brunch to a USB drive

Requirements

  • x86_64 based computer with UEFI boot support
  • Microsoft Windows 10/11 with WSL2
  • 22 GB available (8 GB for the install process, 14 GB for the USB image).
  • Target USB must be 16 GB minimum.

Install process

  1. Identify the recovery suitable for your CPU:

Intel
  8th gen & 9th gen: "shyvana" for Intel / "bobba" for Celeron.
  10th gen: "jinlon".
  11th gen & above: "voxel".

AMD
  Ryzen: "gumboz".

  1. Launch WSL2 and install the PyQtWebEngine package:
    Ubuntu 24.04 and above: sudo apt install python3-venv python3-pyqt6.qtwebengine
    Older Ubuntu versions: sudo apt install python3-venv python3-pyqt5.qtwebengine

  2. Download the linuxloops script.

curl -L https://raw.githubusercontent.com/sebanc/linuxloops/main/linuxloops -O --create-dirs --output-dir ~/bin

  1. Launch the linuxloops script and follow the GUI installer selecting "Brunch" as the distro and the recovery compatible with your CPU as the environment.

bash ${HOME}/bin/linuxloops

Choose "image" at the install type prompt, place the image outside of WSL2 (e.g. /mnt/c/Users/"username"/Downloads) and define the disk image size as 14GB.

  1. Once the install process is finished, use a software like Rufus or Etcher to write the image you have just create to an USB drive.

  2. Reboot your computer and select your USB drive as boot device.

  3. (secure boot enabled) A blue screen saying Verification failed: (15) Access Denied may appear upon boot.

  • To enroll the key directly from a USB, select OK -> Enroll key from disk -> EFI-SYSTEM -> brunch.der -> Continue and reboot.

Next Steps

It is normal for the first boot to take a very long time, please be patient.

Install Brunch to a HDD/SSD

Requirements

  • x86_64 based computer with UEFI boot support
  • Microsoft Windows 10/11 with WSL2
  • 22 GB available (8 GB for the install process, 14 GB for the USB image).
  • A USB drive that must be 16 GB minimum.
  • A HDD/SSD drive that must also be 16 GB minimum.

Install process

  1. Make a Brunch USB flashdrive using the above "Install Brunch to a USB drive" guide.

  2. Boot the ChromeOS USB drive, and switch to the TTY2 terminal with Ctrl + Alt + F2, then login as chronos.

  3. Before continuing, you will need to know what disk you want to install to. Be absolutely sure before you continue, this installation will erase everything on that disk, including other partitions. The disk must be at least 16 GB, or the installation will fail. There are several ways to determine which disk is your target, in this example we will use lsblk.

lsblk -e7

  1. Once you've determined your target disk, you're ready to install Brunch.
  • Replace disk in the below command with your target disk. (Such as sdb, mmcblk0 or nvme0n1 for example)

sudo chromeos-install -dst /dev/disk

The script will ask for confirmation. If you're ready to install, type yes into the prompt.

  1. Reboot your computer and select your HDD/SDD in the boot menu.

Next Steps

It is normal for the first boot to take a very long time, please be patient.

Install Brunch as a disk image (dualboot)

Requirements

  • x86_64 based computer with UEFI boot support
  • Microsoft Windows 10/11 with WSL2
  • 8 GB available.
  • An unencrypted partition with 14 GB available (in ntfs or exfat format).
  • Secure boot disabled.

Install process

  1. Identify the recovery suitable for your CPU:

Intel
  8th gen & 9th gen: "shyvana" for Intel / "bobba" for Celeron.
  10th gen: "jinlon".
  11th gen & above: "voxel".

AMD
  Ryzen: "gumboz".

  1. Launch WSL2 and install the PyQtWebEngine package:
    Ubuntu 24.04 and above: sudo apt install python3-venv python3-pyqt6.qtwebengine
    Older Ubuntu versions: sudo apt install python3-venv python3-pyqt5.qtwebengine

  2. Download the linuxloops script.

curl -L https://raw.githubusercontent.com/sebanc/linuxloops/main/linuxloops -O --create-dirs --output-dir ~/bin

  1. Launch the linuxloops script and follow the GUI installer selecting "Brunch" as the distro and the recovery compatible with your CPU as the environment.

bash ${HOME}/bin/linuxloops

Choose "image" at the install type prompt, place the image on your unencrypted parition and define the disk image size.

  1. Install Grub2win and launch the program.

  2. Click on the Manage Boot Menu button, then click Chrome under 'Import Configuration File'.

  • Select the .grub.txt file in the brunch image folder.
  • Click Import Selected Items
    • Your entry will not be saved unless you click Apply.
  1. Prevent Windows from locking the NTFS partition.

ChromeOS will not be bootable and / or stable if you do not perform the below actions (Refer to Windows online resources if needed):

  • Ensure that bitlocker is disabled on the drive which contains the ChromeOS image or disable it.
  • Disable fast startup.
  • Disable hibernation.

At this point, you are ready to reboot and you'll be greeted by the Grub2win menu instead, select Brunch in the boot menu.

Next Steps

It is normal for the first boot to take a very long time, please be patient.

***

Troubleshooting and Support

See the full Troubleshooting and Support page if you're having issues.

Additional Tips

  • If you're having trouble booting a Brunch USB, make sure that UEFI is enabled in the BIOS.
  • Some PCs require a key to be held when booting to boot from USB or that USB booting is enabled in the BIOS.
  • The first boot can take up to an hour on some hardware. Brunch does not typically freeze on the Brunch logo. If you are seeing the Brunch logo, the system is probably still booting.
  • If your PC is stuck on the ChromeOS logo (White background), it is likely that you've got an incompatible dedicated GPU.
  • If you get a blue screen saying "Verification failed" you can either disable secure boot in your bios settings, or enroll the secure boot key.
    • To enroll the key directly from a USB, select OK -> Enroll key from disk -> EFI-SYSTEM -> brunch.der -> Continue and reboot.
  • If the system reboots itself when booting normally, then Brunch has run into an error and you may need to do some advanced troubleshooting.

In case you run into issues while installing or using Brunch, you can find support on Discord:

Discord