S6-overlay
s6-overlay is a set of scripts and utilities that add the s6 process supervisor as PID 1 inside Docker containers.
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
Variants
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
- Any options for *arr images that don't use s6 overlay? - Reddit (reddit)
- S6 Made Easy, with the S6 Overlay : r/docker - Reddit (reddit)
- Snapcast Server configuration - Home Assistant Community (other)
- Is it possible to use my own `/init` ? - Questions / Help - Fly.io (other)
- OCI Beta + s6-overlay Images: UID/GID and NFS Mount Issues (forum)
- Some docker containers won't start due to s6-overlay-suexec: fatal - Unraid (forum)
Collected 48 days ago - public community threads