Skip to content

[Feature]: Add Add OpenRC support for background service (Alpine Linux) #627

@Baz00k

Description

@Baz00k

Summary

Add OpenRC support so zeroclaw can run as a background service on Alpine Linux

Problem statement

Alpine Linux uses OpenRC instead of systemd. zeroclaw’s Linux background service setup only supports systemd, so Alpine users cannot install a supported service that starts on boot and is managed consistently. This blocks lightweight server/container deployments that rely on Alpine.

Proposed solution

Provide OpenRC service support for zeroclaw:

  • Add an OpenRC init script (e.g., /etc/init.d/zeroclaw)
  • Auto detect which init daemon to use when setting up the zeroclaw service

Non-goals / out of scope

  • No changes to core runtime behavior
  • No systemd changes beyond existing support

Alternatives considered

No response

Acceptance criteria

  • OpenRC init script available and functional on Alpine
  • Documentation includes install/enable/start/stop instructions
  • Service starts automatically on boot and runs zeroclaw reliably

Architecture impact

service

Risk and rollback

Risk: incorrect init script could cause failed boot service or missing logs.
Rollback: remove the OpenRC script and disable the service; existing systemd setup remains unchanged

Breaking change?

No

Data hygiene checks

  • I removed personal/sensitive data from examples, payloads, and logs.
  • I used neutral, project-focused wording and placeholders.

Metadata

Metadata

Labels

enhancementNew feature or request

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions