Set on the container (Compose environment:, Helm values, or the AMI’s overrides file). Every one has a working default; the complete list is in the published .env.example.
Registry, audit log, logs, licence. Persist it — the licence grace clock and cluster identity live here.
LIFEBOAT_SHM_SIZE
8gb
Shared memory for tensor parallelism > 1. Fixed at container creation.
LIFEBOAT_GPU_DEVICE
a no-op self-mapping
Passes an integrated GPU through, e.g. /dev/dri:/dev/dri. The default is deliberately inert: a hardcoded device that the host lacks makes the container refuse to start.
LIFEBOAT_LOG_LEVEL defaults to INFO. At that level the control plane explains its own automatic decisions — the derived memory fraction and why, measured footprints, engine auto-routing, embedding detection, parser corrections. If you are asking why Lifeboat chose something, this is where the answer is.
the bundled engine, or the one lifeboat engine install placed in the data directory
Absolute path to a llama-server binary. Needed when you build the engine yourself — on a Linux release older than Ubuntu 24.04, where the prebuilt binary’s glibc floor is not met.
LIFEBOAT_AUTO_VLLM
on
off keeps Gemma 4 on the tensor engine instead of vLLM.
LIFEBOAT_SPECULATIVE_DEFAULT
on
off makes speculative decoding opt-in again. Otherwise a server that sets none uses a verified draft model or built-in prediction module when one exists.
LIFEBOAT_FP8_KV_DEFAULT
on
off keeps the model’s dtype for the key-value cache. Otherwise a tensor-engine server that sets none gets an FP8 cache on NVIDIA GPUs with compute capability 8.9 or later.
Required today, and specific to the pip package — the desktop installer and the
container image need neither. Set them in the session you start Lifeboat from.
Variable
Set to
Why
PYTHONIOENCODING
utf-8
Without it lifeboat up exits with UnicodeEncodeError: a Windows console encodes stdout as cp1252 and cannot print the startup banner, which happens before the server binds.
HF_HUB_DISABLE_XET
1
Without it a model download can stall at zero bytes or fail with CAS Client Error. Falls back from Hugging Face’s Xet transfer backend to the classic HTTP path.