Skip to Content
Building OsBase Images

Base Images

OpenFactory recipes select a base-image identifier that is resolved by a specific worker and upstream source. The console’s current picker and the validated normalized recipe are the source of truth for which identifiers are available now.

Choose by evidence requirements

NeedStarting familyVerify before use
Conservative server or applianceDebian or Ubuntu LTSUpstream support window, package source, unattended-update policy, hardware drivers
Desktop or GPU workstationUbuntu or another available desktop imageDesktop packages, proprietary-driver licensing, installer, suspend/resume, target GPU
Newer developer packagesFedora or openSUSE where selectableRelease lifetime, package names, SELinux/AppArmor behavior
Virtualization labA selectable Proxmox targetNested-virtualization support, storage, networking, installer, physical-host boot
Edge or board imageA worker explicitly supporting the boardArchitecture, boot firmware, partition layout, peripherals, recovery path

These are starting points, not production recommendations. Upstream image availability does not mean OpenFactory implements every customization for that family.

Compatibility rules

  • Package names and repositories vary by family and release.
  • A feature can be supported on one worker and ignored, substituted, or blocked on another.
  • Desktop themes and settings depend on the installed desktop environment.
  • CIS catalogs are distribution-and-release specific. A fallback catalog is visible as a substitution warning and is not equivalent certification.
  • ISO boot in the hosted VM harness does not prove UEFI, Secure Boot, firmware, driver, suspend, or installer behavior on physical hardware.
  • Upstream URLs, signatures, and support windows can change independently of OpenFactory.

Selection workflow

  1. Select the exact base in the console.
  2. Validate the recipe and review substitutions and unsupported-feature warnings.
  3. Build and inspect the artifact metadata and source provenance.
  4. Require prompt-specific VM assertions in addition to the default suite.
  5. Test installers and hardware-bound behavior on representative hardware.
  6. Pin a known-good recipe and source identity for repeatability.

See Understanding recipes and Testing.