gitwtfhub

wtf is terraos?

r58playz/terraos — explained in plain English

Analysis updated 2026-07-17 · repo last pushed 2024-05-28

★ 51RustAudience · developerComplexity · 4/5DormantSetup · hard

TL;DR

A bootloader that hijacks a Chromebook's recovery feature to boot full Linux distros like Arch, giving you complete control over the device.

Mindmap

mindmap
  root((terraOS))
    What it does
      Hijacks RMA shim
      Swaps filesystem
      Boots Linux distros
    Tech stack
      Rust
      Arch Linux
      ext4
    Use cases
      Reclaim old Chromebook
      Run Linux apps
      Full OS control
    Audience
      Power users
      Developers
    Limits
      x86_64 best supported
      ARM experimental

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Boot Arch Linux or another distro on a Chromebook by exploiting its RMA recovery shim

REASON 2

Reclaim an aging Chromebook to run traditional Linux applications and tools

REASON 3

Create a bootable USB that installs Linux permanently to the Chromebook's internal storage

What's in the stack?

RustArch Linux

How it stacks up

r58playz/terraoslucifer1004/veloqpsiini/israeli-alloc
Stars515151
LanguageRustRustRust
Last pushed2024-05-28——
MaintenanceDormant——
Setup difficultyhardmoderatehard
Complexity4/54/55/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1day+

Requires an Arch Linux build machine, manual partitioning, and possibly patching systemd for non-Arch distros.

Yoink these prompts

Prompt 1
Walk me through building terraOS on an Arch Linux machine to create a bootable USB for my Chromebook.
Prompt 2
Explain how terraOS uses a Chromebook's RMA shim recovery feature to boot a full Linux distro instead of Chrome OS.
Prompt 3
How do I patch systemd with Chrome OS compatibility fixes to run a non-Arch distro with terraOS?
Prompt 4
What are the current limitations of terraOS on ARM-based 'jacuzzi' Chromebook boards versus x86_64 models?

Frequently asked questions

wtf is terraos?

A bootloader that hijacks a Chromebook's recovery feature to boot full Linux distros like Arch, giving you complete control over the device.

What language is terraos written in?

Mainly Rust. The stack also includes Rust, Arch Linux.

Is terraos actively maintained?

Dormant — no commits in 2+ years (last push 2024-05-28).

How hard is terraos to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is terraos for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane