chromebook-linux-postinstall

Post-install configuration for Fedora on the ASUS Chromebook Flip C434 (Amber Lake Y).

Quick Start · Installation · Contributing · License

Why this exists: I flashed coreboot and installed Fedora on my ASUS Chromebook Flip C434, then found the Chrultrabook post-install left several hardware tweaks unfinished. This repo handles the rest.

What is chromebook-linux-postinstall?

chromebook-linux-postinstall is a set of Bash scripts that configure Fedora on an ASUS Chromebook Flip C434 (Amber Lake Y, m3-8100Y). After flashing coreboot and running the Chrultrabook post-install, the hardware still needs several tweaks: VAAPI video decode, eMMC tuning, screen rotation, tablet mode, zram, journald limits, TRIM, CPU governor, swappiness, mpv config, and browser VAAPI flags.

postinstall.sh applies the configuration, and verify.sh confirms every setting persisted after a reboot.

Test hardware

Component	Spec
Model	ASUS Chromebook Flip C433/C434 (Amber Lake Y)
CPU	Intel Core m3-8100Y (2C/4T, 1.1 / 3.4 GHz, 5W TDP)
GPU	Intel UHD Graphics 615 (Gen 9.5, GT2, 24 EUs)
RAM	8 GB LPDDR3
Storage	58 GB eMMC
Firmware	coreboot (MrChromebox)
OS	Fedora 44 KDE Plasma Spin
Desktop	KDE Plasma 6 (KWin Wayland compositor)

Quick start

Run this on a fresh Fedora 44 KDE Plasma installation:

# 1. Clone and inspect
git clone https://github.com/j3n0v4/chromebook-linux-postinstall.git
cd chromebook-linux-postinstall

# 2. Review, then apply (needs root)
sudo ./postinstall.sh --dry-run
sudo ./postinstall.sh

# 3. Reboot and verify
sudo reboot
sudo ./verify.sh

The dry run prints every change without touching the system. The live run applies all configuration steps idempotently (safe to re-run).

Installation

Full setup steps — coreboot flash, Fedora install, the Chrultrabook post-install, and postinstall.sh — are in INSTALL.md.

Prerequisite guides:

• MrChromebox firmware — coreboot flash
• Chrultrabook — Post Install — audio + keyboard

What the script configures

postinstall.sh applies all of the following, idempotently (safe to re-run):

• eMMC tuning — Auto-detects btrfs vs ext4 and applies correct mount options (noatime, discard). Without this, default settings wear out the 58 GB eMMC faster.
• Zram — 4 GB zram with lz4 compression, swap-on-disk disabled. Prevents eMMC wear from swap writes.
• VAAPI — Installs libva-intel-media-driver for hardware video decode. Without this, video runs on CPU and the fanless 5W chip thermal-throttles.
• Screen rotation — Systemd user service that polls the cros-ec-accel display accelerometer via kscreen-doctor for KDE Plasma 6 Wayland. Dynamic device discovery because iio device numbers change across reboots.
• Tablet mode — Udev-triggered script that disables the internal keyboard when the lid is flipped past 360°. Uses dynamic device discovery.
• Touchpad — KDE Plasma 6 Wayland handles touchpad natively via KWin/libinput. No X11 config needed.
• CPU governor — Sets the CPU governor to performance and persists it across reboots via a systemd oneshot service.
• Swappiness — Reduces vm.swappiness to 10 to minimize eMMC writes from swap activity.
• Journald — Limits log volume to 50M system / 25M runtime. Without this, logs fill the 58 GB eMMC.
• TRIM — Enables weekly fstrim. Without this, the eMMC cannot reclaim deleted blocks efficiently.
• mpv — Configures mpv with VAAPI hardware decoding and Wayland GPU context.
• Browser VAAPI — Sets environment flags for Chromium/Brave to enable VAAPI hardware video decode on Wayland.
• Brightness — Installs brightnessctl with a udev rule granting the video group backlight write access.

Hardware status

Component	Notes
WiFi	Intel Wireless-AC 9560 — works out of the box
Bluetooth	Intel Bluetooth — works out of the box
Display	1920×1080 internal panel — works out of the box
USB-C	Charging, display output, data — works out of the box
Webcam	Works out of the box

Known limitations

• Audio may break after kernel updates — The Chrultrabook audio script uses ALSA UCM configs that can get overwritten. Re-run the setup if speakers go silent after dnf upgrade.
• iio-sensor-proxy cannot read cros-ec-accel — Known Chromebook bug. The rotation script polls the accelerometer directly instead.
• Auto-rotation — The systemd user service polls every second. It needs a logged-in KDE Plasma session. Enable with systemctl --user enable --now kde-rotate.service after login.

Verification

verify.sh checks every postinstall setting and reports pass/fail:

sudo ./verify.sh

Contributing

Contributions are welcome. If you run Fedora on an ASUS Chromebook C434 (or similar Amber Lake Y hardware), test the scripts and open an issue or pull request. Keep changes specific to this hardware, and document any new fix with the "why" so it stays maintainable.

License

MIT © 2026 JD Cordero