WEFT_OS/infra/vm/linux-dev-environment.md
Marco Allegretti 29a7f6f508
ci: build and test on Linux only
WEFT OS targets Linux and systemd. The Windows runner only compiled and
tested the crates without Linux system libraries, which says nothing
about a supported configuration, and was the slowest job in every run.

The job is now `portable` on Ubuntu, matching the verification profile
of the same name. The building guide, README and development
environment notes now state that builds are validated on Linux only.
2026-10-09 08:16:59 +00:00

1.4 KiB

Linux Development Environment

WEFT OS is developed on a Windows workstation, but the authoritative runtime target for system work is a Linux VM or QEMU guest.

Baseline target

Use a recent Linux distribution with:

  • systemd as PID 1
  • Wayland-capable graphics stack
  • Mesa userspace drivers
  • a recent Rust toolchain compatible with rust-toolchain.toml

Purpose of the guest environment

The guest is the validation target for:

  • systemd service assumptions
  • Wayland compositor bring-up
  • Servo Wayland client behavior
  • Wasmtime runtime supervision assumptions

Host versus target boundary

The Windows host is acceptable for editing and documentation. Builds and tests are validated on Linux only; CI does not build on Windows.

The Linux guest is authoritative for:

  • graphics stack behavior
  • compositor and shell startup order
  • systemd unit behavior
  • process supervision assumptions tied to Linux userspace

Minimum guest setup goals for the next implementation wave

  • install Rust toolchain matching rust-toolchain.toml
  • install build essentials needed by Rust crates in this repository
  • confirm cargo fmt, cargo clippy, and cargo test run successfully
  • prepare a repeatable guest definition for future compositor and shell work

Current status

This repository does not yet automate guest provisioning. That work should begin only after the foundational workspace and design documents are stable.