zeroclaw-labs/zeroclaw · error · anyhow::Error

OpenRC service installation requires root privileges. Please

Error message

OpenRC service installation requires root privileges.
Please run with sudo: sudo zeroclaw service install

What it means

Error "OpenRC service installation requires root privileges. Please run with sudo: sudo zeroclaw service install" thrown in zeroclaw-labs/zeroclaw.

Source

Thrown at crates/zeroclaw-runtime/src/service/mod.rs:1837

        config_dir = config_dir.display().to_string(),
        output_logger = output_logger,
        error_logger = error_logger,
    )
}

fn resolve_openrc_executable() -> Result<PathBuf> {
    let preferred = Path::new("/usr/local/bin/zeroclaw");
    if preferred.exists() {
        return Ok(preferred.to_path_buf());
    }

    let exe = std::env::current_exe().context("Failed to resolve current executable")?;
    Ok(exe)
}

fn install_linux_openrc(config: &Config) -> Result<()> {
    if !is_root() {
        bail!(
            "OpenRC service installation requires root privileges.\n\
             Please run with sudo: sudo zeroclaw service install"
        );
    }

    let exe = resolve_openrc_executable()?;
    if !openrc_executable_path_is_safe(&exe) {
        bail!(
            "OpenRC service executable path contains unsupported shell characters: {}. Install ZeroClaw at /usr/local/bin/zeroclaw and retry",
            exe.display()
        );
    }
    ensure_zeroclaw_user()?;
    warn_if_binary_in_home(&exe);

    let config_dir = Path::new("/etc/zeroclaw");
    let workspace_dir = config_dir.join("workspace");
    let log_dir = Path::new("/var/log/zeroclaw");

View on GitHub (pinned to 88bb9c8533)

Solutions

1. Run with sudo: sudo zeroclaw service install.

When it happens

Trigger: Thrown at crates/zeroclaw-runtime/src/service/mod.rs:1837 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zeroclaw-labs/zeroclaw@88bb9c8533 (2026-08-23). Data as JSON: /api/errors/5d876e1c7ae63451. Report an issue: GitHub.