gbOS86

Install & Docs

Everything about gbOS86: installing it, how it works, and how to fix it when something is wrong.

Overview

What gbOS86 is, what is tested, and how the pieces fit.

Install

Create the USB stick, boot, try it live, install or update.

How it works

The boot chain from UEFI to Android init.

CPU emulation and patches

Why Google's OS needs emulation here, and how it is made fast.

Hardware detection

How drivers and firmware are chosen at each boot, and the hwdetect.txt report.

Google-only hardware

The services and devices that do not exist on other laptops, and what replaces them.

Configuration

Every setting in gbos/gbos.cfg.

Logs and debugging

Where the logs are, what each file shows, and how to send a useful report.

Updating

Updating gbOS86 on a laptop, and moving to a newer Google build.

Building from source

The outline of building the kernel, payload and image.

Safety and limits

What can go wrong, and what this is not.

Changelog

Milestones of the project.