Files
bc250-console/README.md
T
ckochandClaude Fable 5 06ad5e9d26 Clean repo down to what the console image actually uses
- Rewrite README for this fork's purpose (was upstream's multi-image doc)
- Remove 40-CU tooling (files/system, vendor/, docs/, justfiles) — this
  image is deliberately stable-24CU only
- Remove upstream CI (GitHub workflows, release scripts) — builds are
  local, repo lives on Gitea
- Remove unused upstream recipes (deck/kde/gnome × plain/40cu)
- Remove upstream's cosign.pub — we don't sign; keeping their key was
  misleading (verified: recipe generates fine without it, no key baked)
- Update NOTICE: drop removed vendored projects, credit direct upstream

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-07 15:32:11 -04:00

2.9 KiB

bc250-console

A custom Bazzite GNOME (bootc) image for the AMD BC-250, built as a kid-friendly couch gaming console with remote parent administration. Recipes build with BlueBuild; the installer ISO comes from bootc-image-builder; installed consoles update over-the-air from this Gitea's container registry.

Image: git.lazypugs.com/ckoch/bc250-console-gnome:latest Recipe: recipes/bc250-console-gnome.yml

What it adds on top of bazzite-gnome:stable

Area Change
GPU cyan-skillfish-governor-smu (BC-250 DVFS governor, from the filippor COPR), enabled
Memory ttm.pages_limit / ttm.page_pool_size kargs so the GPU can use the full 16 GB shared GDDR6
Remote admin openssh-server (enabled) + gnome-remote-desktop (RDP); one-time bc250-remote-setup script; tailscaled enabled
Console behavior All suspend paths masked, no screen lock/dim, GNOME animations off — always on, always reachable
Kid experience Steam Big Picture autostarts for the kid account only
Apps First-boot flatpaks: ProtonUp-Qt, Heroic, RetroDECK (Steam, Firefox, auto-updates already in the Bazzite base)
Fixes hhd.service masked (crash-loops on BC-250)
Docs Parent manual baked at /usr/share/doc/bc250-console/OPERATIONS.md

Accounts

The ISO installs unattended and bakes two users from iso-config.toml: parent (admin/wheel) and kid (standard), both with a placeholder password to change on first login.

⚠️ The installer wipes the first disk with no prompts. Don't boot it on a machine whose disk you care about.

Documentation

  • BUILD-CONSOLE.md — build the image, generate the ISO, publish OTA updates (verified podman and docker paths, with workarounds)
  • OPERATIONS.md — day-2 admin: connecting, installing games remotely, updates/rollback, GPU tuning, health checks

Hardware prerequisites (on the board, not in the image)

Modded BIOS (see mothenjoyer69/bc250-documentation), then BIOS settings: 512 MB dynamic VRAM, IOMMU disabled, auto power-on.

Credits

Forked from 62fixolab/Latest-Bazzite-AMD-BC-250-Patched-Images, which builds on vietsman's patched images and filippor/cyan-skillfish-governor, on top of ublue-os/bazzite. The 40-CU experimental tooling from upstream is intentionally not included — this image stays on the stable 24-CU configuration.

MIT licensed — see LICENSE and NOTICE.