S6-overlay

s6-overlay is a set of scripts and utilities that add the s6 process supervisor as PID 1 inside Docker containers.

  • Tools & Utilities
s6-overlay is a set of scripts and utilities that add the s6 process supervisor as PID 1 inside Docker containers. It gives containers staged init, service supervision, log rotation, and reliable start/stop/restart behaviour so multi-process applications run correctly. Homelabbers use it when building custom container images from standard apps that need a proper init system.

Platform availability

Available on 0 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

65/100 Good

Maintained
79last commit 26 days ago
Popular
734,616 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
No data
Security check
65no serious findings, CI, OpenSSF Scorecard 3.4/10

Based on 4 of 5 factors.

GitHub stars
4,616
Open issues
8
Last commit
2026-10-26
Latest release
v3.2.3.2
Activity
rising

Checked 16 days ago - source: GitHub (just-containers/s6-overlay)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Installation s6-overlay installs s6 as PID 1 in any Docker image via two tarballs, providing staged init, service supervision, and log rotation; a service script is required. source

Fetched 42 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I add s6-overlay to an existing container image?

Extract a tarball or two into the image. It then provides scripts and utilities for using s6 as pid 1 and as a process supervisor.

Where should I start when diagnosing common s6-overlay issues?

Use the troubleshooting page for containerized s6-overlay issues. It points to separate initialization and environment-variable references for configuration.

Does s6-overlay conflict with Fly.io's init?

A Fly.io thread reports a conflict with the platform's /init when trying to run multiple services or a custom supervisor.

How can I simplify a Kubernetes setup that uses s6-overlay with nginx and PHP-FPM?

Move nginx into a sidecar container for the PHP pod and remove the s6 component.

Do Hotio and LSIO *arr container images use s6-overlay?

Yes, both Hotio and LSIO *arr images use s6-overlay.

Answers sourced from community.fly.io, deepwiki.com, github.com, www.reddit.com, www.reddit.com

Community

Collected 48 days ago - public community threads