Skip to content

Install Host

Official Linux x86-64 release archives are self-contained. From the extracted, signed release directory:

Terminal window
sudo ./install.sh

The installer adds only packages Podman needs, installs the exact bundled runtime, enables the Host service, and fails unless /healthz becomes ready. It does not ask users to run Cargo, build OCI images, configure cgroups, or execute the developer qualification harness.

From a source checkout:

Terminal window
cargo build --manifest-path host/Cargo.toml --bins
FORMLESS_TTY_FIXTURE=1 cargo run --manifest-path host/Cargo.toml --bin formless-host

Defaults expose Host at http://127.0.0.1:8787. Confirm health before pairing Click:

Terminal window
curl --fail http://127.0.0.1:8787/healthz
Variable Purpose
FORMLESS_HOST_ADDR Listener address
FORMLESS_HOST_DATA_DIR Durable SQLite and artifact directory
FORMLESS_HOST_ID Stable policy-authority identity
FORMLESS_PLUGIN_MAX_ACTIVE Maximum admitted live generations; default 32
FORMLESS_PLUGIN_MAX_MEMORY_MIB Total plugin memory admission; default 8192 MiB
FORMLESS_PLUGIN_IDLE_GRACE_SECONDS Idle generation retention
FORMLESS_OTLP_ENDPOINT Optional non-blocking telemetry export

Continue with your first workspace.