Guides

Host security

Prepare a host to isolate mutually untrusted apps.

Each app runs in a separate Firecracker microVM. The jailer gives its VMM a filesystem boundary and a non-root host identity. CPU and memory cgroups limit resource consumption. These boundaries depend on the host kernel, CPU firmware and host configuration.

Prepare the host

For workloads that must not trust each other, apply these requirements before deploying apps:

RequirementCheck
Host SMT disabledcat /sys/devices/system/cpu/smt/active reports 0.
Kernel samepage merging disabled, with no retained shared pagesInspect /sys/kernel/mm/ksm/run and /sys/kernel/mm/ksm/pages_shared. A kernel without KSM support also meets this requirement.
Current host kernel and CPU microcodeFollow the distribution's security advisories and reboot when required.
Current guest kernel and FirecrackerUpgrade nibrunner and its guest image; redeploy apps to replace existing VMMs and guest kernels.

These are host preparation requirements. They do not establish that a CPU is free of hardware vulnerabilities. Follow Firecracker's production host guidance and the Linux hardware vulnerability documentation for the CPU in use. Installation and daemon startup require inactive SMT and KSM with no retained shared pages. A kernel without KSM support meets the KSM requirement.

Host SMT

Simultaneous multithreading lets logical CPUs share one physical core. A hostile workload can exploit some CPU vulnerabilities to observe data processed on its sibling thread.

Disable SMT in the machine's firmware or through the distribution's persistent kernel boot configuration, then verify the running kernel's smt/active value. Keep it disabled while apps run. An absent or unreadable status file does not establish that SMT is disabled. Installation and daemon startup refuse active, missing, unreadable or unknown SMT status before mounting storage, adopting existing VMs or starting new ones. Hosts without active SMT siblings report 0, including hardware without SMT support.

The guest machine configuration's smt: false describes virtual CPU topology. It does not disable SMT on the host. CPU quotas do not reserve physical cores or prevent sibling sharing.

Disabling SMT can reduce aggregate CPU throughput. Measure the apps' throughput and latency before sizing a production host. The capacity estimate considers memory, disk and ports; it does not measure CPU throughput.

Kernel samepage merging

KSM can deduplicate identical anonymous memory pages. Sharing pages between workloads enables side channels. Disable services that enable KSM and keep it disabled across reboots. Installation and daemon startup refuse run = 1, retained shared pages, or status that cannot be verified. Both run = 0 and run = 2 are accepted when pages_shared is zero.

Stopping KSM with run = 0 retains already merged pages. Unmerging them with run = 2 can increase memory usage enough to trigger the OOM killer. Schedule this change with enough free memory, or stop workloads first, and verify that pages_shared reaches zero. See the Linux KSM documentation.

CPU vulnerability reports

At daemon startup, nibrunner logs each assessment from /sys/devices/system/cpu/vulnerabilities/ with its kernel-provided name and description. Reports that say vulnerable, unknown or use an unrecognised format produce warnings. Missing or unreadable assessments also produce warnings. Partial mitigations that still report vulnerability produce warnings even when their description starts with Mitigation:.

These reports are informational and do not block startup. They do not replace the SMT and KSM requirements or certify that a host is secure. Follow the distribution and CPU vendor's guidance for each assessment. To read the startup reports:

journalctl -u nibrunnerd -b

Nested virtualisation

A VPS needs nested virtualisation to expose /dev/kvm. Its CPU topology and mitigation reports describe the virtual hardware presented by the provider. They cannot establish which other workloads share the underlying physical cores. Use a provider whose isolation policy meets the workloads' requirements; guest-local SMT settings cannot enforce that policy.

Upgrade planning

Check host settings before upgrading or restarting nibrunner. Host security changes can require a reboot, affect other services on the same machine and change usable capacity. Before upgrading to a version that enforces inactive SMT, verify smt/active reports 0. An unsuccessful daemon restart prevents wakes and routing updates even if existing VMM processes remain alive. An existing HTTP worker keeps its last routes to running guests. A VPS with unavailable SMT status cannot satisfy this check; verify its compatibility before upgrading. Also verify KSM is stopped and has no retained shared pages before upgrading to a version that enforces the KSM requirement. Keep host settings persistent: a startup check cannot prevent a host administrator from changing them after apps have started.

On this page