Skip to content

Build Environment

Tim edited this page Aug 15, 2026 · 3 revisions

Build environment

Developer documentation. Full detail: docs/NEBULAOS_BUILD_ENVIRONMENT.md — this page is a summary.

Since the Migration A / Final Closure mission (2026-08-15), every build stage — including GuppyScreen's MIPS cross-compile — runs inside one unified, digest-pinned image: ghcr.io/coreflake1/nebulaos-build, pinned by BUILD_IMAGE_REPO/BUILD_IMAGE_DIGEST in manifests/dependencies.conf. The image is public and pullable with no authentication.

Retired (pre-2026-08-15) architecture — do not document these as current:

  • pellcorp/k1-bash-build (nested nested-Docker build container)
  • ghcr.io/coreflake1/guppydev (separate GuppyScreen toolchain container)

GuppyScreen's build now uses the same Bootlin mips32el--musl toolchain guppydev used to provide, bundled into the unified image on a non-default PATH entry (GUPPYSCREEN_TOOLCHAIN_BIN) rather than the image's global PATH.

A small number of rare, one-off vendored-dependency maintenance/re-vendoring scripts (not part of any normal build or CI run) may still reconstruct a Pellcorp-compatible toolchain layout — see NebulaOS-guppyscreen's Vendored Dependencies page for exactly which scripts and why. This is not a current build dependency.

See also: Build From Source, Build Provenance.

Clone this wiki locally