Skip to content

Installation and service operation

From an extracted, signed official Linux x86-64 release:

Terminal window
sudo ./install.sh

The installer installs the pinned runsc and adapter, adds only Podman OS dependencies, enables the Host system service, and waits for /healthz. End users do not run qualification or compile plugin images.

Terminal window
cargo run --manifest-path host/Cargo.toml --bin formless-host

Use FORMLESS_HOST_ADDR, FORMLESS_HOST_DATA_DIR, and FORMLESS_HOST_ID to select listener, durable state, and authority identity.

Upgrade using the signed release’s installer and its bundled runtime. Preserve the Host data directory. Host reconciles installed plugin records from durable state rather than trusting ambient Podman containers.

Service/package removal and destructive data deletion are separate operations. Back up the Host data directory before removal. Plugin uninstall retains private data; only explicit purge data removes it.

This documentation does not provide an unverified distro-specific removal command because the public release packaging channel is not frozen yet.