Skip to main content

Platform Support

Fabric separates a target that builds from a platform that has passed the full release contract. A Tier 1 release requires clean installation, update, repair, rollback, uninstall, signing/checksum verification, and core end-to-end tests on that platform.

Tier 1 — release blocking

PlatformEngine surfaceDesktop surfaceCurrent distribution
macOS 13+ arm64CLI, TUI, gateway, dashboardNative Fabric app; DMG + zip package targetPublic source checkout; packaged release requires Developer ID signing + notarization
Windows 10/11 x64Native CLI/TUI/gateway/dashboard, subject to the Windows feature matrixNative Fabric app; NSIS + MSI package targetPackage CI target; public installer requires Authenticode signing and clean-machine evidence
Ubuntu 22.04/24.04 x86_64Headless CLI, gateway, dashboard, servicesLinux desktop packages are previewPublic source checkout
Docker Linux amd64Headless engine and gatewayNo desktop shell in the containerAn immutable Fabric-owned image reference supplied by the release owner

Tier 1 is the intended support contract. A row is not proof that a signed installer is already public. Check the Fabric release page for actual release assets and checksums.

Tier 2

Nightly and support validation:

PlatformPolicy
macOS x86_64Compatibility/nightly target; not a release-blocking desktop architecture
Windows arm64Compatibility/nightly target; native installer evidence is still required
Linux arm64Headless and package compatibility target
WSL2Supported source environment; native Windows and WSL profiles remain separate
Docker Linux arm64Multi-architecture image target once an immutable Fabric image is published

Tier 2 failures block a claim that the affected platform is fully supported, but do not block an unrelated Tier 1 hotfix.

Mobile remote clients — preview

Fabric provides an installable PWA plus source-checkout SwiftUI and Jetpack Compose clients for remotely controlling a gateway that runs on a supported computer. Simulator builds and native unit tests run in CI, but signed store artifacts and physical-device acceptance evidence are not yet published. This preview is separate from running Fabric itself through Android/Termux.

See Mobile access for the supported pairing, security, and installation paths.

Raspberry Pi, NVIDIA Jetson, and other arm64 single-board computers fall under Linux arm64. Step-by-step walkthroughs: Install on Raspberry Pi and Install on Jetson Nano. For the lean profile that fits 1 GB devices — including memory options that avoid a local embedding stack — see Low-Memory Devices.

Tier 3 — experimental

  • Android through Termux
  • Nix/NixOS
  • Linux distributions outside the recorded Ubuntu clean-machine matrix
  • custom or repackaged desktop installers

These paths can work, but they carry explicit limitations and do not inherit the Tier 1 release promise.

Desktop packaging contract

The canonical desktop identity comes from apps/desktop/branding/fabric.json. Native packaging CI must build on the native host and produce the manifest-derived artifact stem:

CI hostRequired outputs
macOS arm64Fabric-<version>-mac-arm64.dmg, .zip
Windows x64Fabric-<version>-win-x64.exe, .msi
Linux x64Fabric-<version>-linux-x64.AppImage, .deb, .rpm

CI outputs are short-lived, unsigned verification artifacts. A production desktop release additionally needs:

  1. a Fabric-controlled signing identity for macOS and Windows;
  2. Apple notarization and staple verification for macOS;
  3. Authenticode verification for both Windows formats;
  4. checksums generated after signing;
  5. clean-machine install, launch, update, rollback, and uninstall evidence; and
  6. publication under ObliviousOdin/fabric.

Source-install boundary

The verified Fabric installation starts from the public ObliviousOdin/fabric checkout. Signed desktop packages remain release gates until they are present and independently verified. Follow Install Fabric, and only trust release assets published by the official repository.

fabric version