zeroclaw-labs/zeroclaw · error · anyhow::Error
Failed to create zeroclaw user
Error message
Failed to create zeroclaw user: {} What it means
On Alpine, `adduser -S -s /sbin/nologin -H -D -G zeroclaw zeroclaw` exited with an error whose stderr is embedded. Common causes: the zeroclaw group was not created first, the user already exists in a partial state, or busybox adduser rejected an argument combination.
Solutions
- Run the service install with sudo and check useradd error detail.
Defensive patterns
Strategy: validation
When it happens
Trigger: Thrown at crates/zeroclaw-runtime/src/service/mod.rs:1517 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/5b25755ac84f323b.
Report an issue: GitHub.
Appendix: source
Thrown at crates/zeroclaw-runtime/src/service/mod.rs:1517
}
let output = Command::new("adduser")
.args([
"-S",
"-s",
"/sbin/nologin",
"-H",
"-D",
"-G",
"zeroclaw",
"zeroclaw",
])
.output()
.context("Failed to create zeroclaw user")?;
if !output.status.success() {
let stderr = String::from_utf8_lossy(&output.stderr);
bail!("Failed to create zeroclaw user: {}", stderr.trim());
}
} else {
let output = Command::new("useradd")
.args(["-r", "-s", "/sbin/nologin", "zeroclaw"])
.output()
.context("Failed to create zeroclaw user")?;
if !output.status.success() {
let stderr = String::from_utf8_lossy(&output.stderr);
bail!("Failed to create zeroclaw user: {}", stderr.trim());
}
}
println!("✅ Created system user: zeroclaw");
Ok(())
}
/// Change ownership of a path to zeroclaw:zeroclawView on GitHub (pinned to 88bb9c8533)