ckochandClaude Fable 5
06ad5e9d26
- 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>
57 lines
2.9 KiB
Markdown
57 lines
2.9 KiB
Markdown
# bc250-console
|
|
|
|
A custom [Bazzite](https://bazzite.gg) GNOME (bootc) image for the **AMD
|
|
BC-250**, built as a kid-friendly couch gaming console with remote parent
|
|
administration. Recipes build with [BlueBuild](https://blue-build.org); 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`](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](https://copr.fedorainfracloud.org/coprs/filippor/bazzite/)), 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`](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-CONSOLE.md) — build the image, generate the ISO,
|
|
publish OTA updates (verified podman and docker paths, with workarounds)
|
|
- [`OPERATIONS.md`](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](https://github.com/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](https://github.com/62fixolab/Latest-Bazzite-AMD-BC-250-Patched-Images),
|
|
which builds on [vietsman's patched images](https://github.com/vietsman/bazzite-gnome-patched)
|
|
and [filippor/cyan-skillfish-governor](https://github.com/filippor/cyan-skillfish-governor),
|
|
on top of [ublue-os/bazzite](https://github.com/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](LICENSE) and [NOTICE](NOTICE).
|