# S6-overlay

S6-overlay is a set of scripts and utilities that add the s6 process supervisor as PID 1 inside Docker containers. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5882/s6-overlay

## Description

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.

## Health score

65/100 (Good), based on 4 of 5 factors.
- Maintained: 79 (last commit 26 days ago)
- Popular: 73 (4,616 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Security check: 65 (no serious findings, CI, OpenSSF Scorecard 3.4/10)

## Links

- Docker Hub: https://hub.docker.com/r/shinsenter/s6-overlay
- GitHub: https://github.com/just-containers/s6-overlay
- Official website: https://code.shin.company

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/5882/s6-overlay), the self-hosted and open-source app directory.
