Skip to content

Linux desktop packaging

Build separate bundles for glibc / musl and ARM64 / x86_64.

Requirements

  • Docker or a compatible engine.
  • Required DVC inputs: assets, CLI assets, terminal-raster assets and extension fonts.
  • Prefer a native runner for each architecture. Emulation needs host binfmt support.
Bundle Build image Minimum libc
glibc Ubuntu 22.04 glibc 2.35
musl Alpine 3.22 Matching musl runtime

Keep the glibc baseline unless deliberately raising the supported minimum.

Build

python3 packaging/linux/build_container.py --libc glibc --arch arm64
python3 packaging/linux/build_container.py --libc musl --arch arm64

Repeat with --arch x86_64 on an x86_64 runner.

  • Output folder: dist/linux-<arch>-<libc>/.
  • Release archive: dist/graffitty-linux-<arch>-<libc>.tar.gz.
  • Dependency and ABI audit: build.json and DEPENDENCIES.txt.
  • Builds use an isolated source snapshot, including current edits.
  • --resume build/linux-containers/<workspace> reuses that snapshot; later checkout edits are not copied in.

Prepared native environment

The container handles staging. To export manually:

python3 packaging/linux/prepare_bundle.py --libc glibc \
  --godot /path/to/built/godot --template /path/to/built/template \
  --godot-source /path/to/godot/source \
  --server target/aarch64-unknown-linux-gnu/release/gft

First stage the matching Godot extension and build the filetree runtime with tools/build_filetree_runtime.py --libc ... --neovim-prefix .... Never mix glibc binaries into a musl bundle.

Include Chromium

Default bundles omit CEF.

  1. Build the matching host with apps/server/chromium/build-linux.sh.
  2. Pass --chromium-runtime /path/to/complete/runtime to the exporter.
  3. Include graffitty_chromium, libcef.so, resources and runtime licences.

  4. Cached Linux CEF artifacts exist for x64 and ARM64.

  5. ARM64 is build verified; application acceptance remains pending.
  6. The exporter rejects CEF on musl until a validated runtime exists.

See release validation, publication, and install layout.