A Minimized Java Service Wrapper

Run Java applications as native services on macOS, Windows, and Linux.

Originally created for OneDev, a development platform with Git hosting, issue tracking, and CI/CD, Service Wrapper is now a standalone project that other Java applications can use too.

Inspired by Java Service Wrapper (JSW), this project borrows some JSW configuration conventions. Its native supervisor is a clean room rewrite in Rust, with a small Java bridge.

The focus is minimal service integration: installation, startup, graceful shutdown, log rotation, and application-requested restarts. Advanced JSW features such as automatic crash recovery, JVM monitoring, and event or scheduled actions are outside its scope.

Requires Java 17+. Supports macOS arm64 and Windows/Linux amd64 and arm64.

On systemd, systemctl start waits for the JVM bridge to connect and reports a failed start if the launcher cannot execute or the JVM fails before that point. This confirms JVM startup, not application readiness. Detailed errors are in systemctl status and journalctl -u <service>; the launcher's start command also prints captured startup errors. Existing systemd services must be removed and installed again to update their unit to Type=notify.

Download · Wiki · MIT license