tinyhumansai/openhuman · error · io::Error

Docker not found

Error message

Docker not found

What it means

Constructor guard in DockerSandbox::new(): is_installed() probes for the `docker` CLI and this NotFound error is returned when Docker is absent, so the container-based sandbox backend (default image alpine:latest) cannot be constructed on this host.

Source

Thrown at src/openhuman/security/docker.rs:25

#[derive(Debug, Clone)]
pub struct DockerSandbox {
    image: String,
}

impl Default for DockerSandbox {
    fn default() -> Self {
        Self {
            image: "alpine:latest".to_string(),
        }
    }
}

impl DockerSandbox {
    pub fn new() -> std::io::Result<Self> {
        if Self::is_installed() {
            Ok(Self::default())
        } else {
            Err(std::io::Error::new(
                std::io::ErrorKind::NotFound,
                "Docker not found",
            ))
        }
    }

    pub fn with_image(image: String) -> std::io::Result<Self> {
        if Self::is_installed() {
            Ok(Self { image })
        } else {
            Err(std::io::Error::new(
                std::io::ErrorKind::NotFound,
                "Docker not found",
            ))
        }
    }

    pub fn probe() -> std::io::Result<Self> {

View on GitHub (pinned to 7491200858)

Solutions

1. Install Docker Engine or Docker Desktop and ensure the `docker` CLI is on PATH
2. Start the Docker daemon if installed but stopped
3. Fall back to another sandbox backend (bubblewrap, landlock) via sandbox_mode

When it happens

Trigger: Thrown at src/openhuman/security/docker.rs:25 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/bea947110521ae9b. Report an issue: GitHub.