tinyhumansai/openhuman · error · io::Error

Firejail not found. Install firejail using your system packa

Error message

Firejail not found. Install firejail using your system package manager.

What it means

Constructor guard in FirejailSandbox::new(): is_installed() probes for the `firejail` SUID binary and this error fires when it is missing, meaning the Linux user-space sandbox backend cannot be instantiated. The message itself already carries the remediation hint.

Source

Thrown at src/openhuman/security/firejail.rs:18

//! Firejail sandbox (Linux user-space sandboxing)
//!
//! Firejail is a SUID sandbox program that Linux applications use to sandbox themselves.

use crate::openhuman::security::traits::Sandbox;
use std::process::Command;

/// Firejail sandbox backend for Linux
#[derive(Debug, Clone, Default)]
pub struct FirejailSandbox;

impl FirejailSandbox {
    /// Create a new Firejail sandbox
    pub fn new() -> std::io::Result<Self> {
        if Self::is_installed() {
            Ok(Self)
        } else {
            Err(std::io::Error::new(
                std::io::ErrorKind::NotFound,
                "Firejail not found. Install firejail using your system package manager.",
            ))
        }
    }

    /// Probe if Firejail is available (for auto-detection)
    pub fn probe() -> std::io::Result<Self> {
        Self::new()
    }

    /// Check if firejail is installed
    fn is_installed() -> bool {
        Command::new("firejail")
            .arg("--version")
            .output()
            .map(|o| o.status.success())
            .unwrap_or(false)

View on GitHub (pinned to 7491200858)

Solutions

1. Install firejail with the distribution package manager (apt install firejail, dnf install firejail)
2. Ensure the firejail binary is on PATH for the user running the core
3. Select a different sandbox backend (landlock, bubblewrap, docker) in agent sandbox config

When it happens

Trigger: Thrown at src/openhuman/security/firejail.rs:18 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/6f2fb61802f0972d. Report an issue: GitHub.