How just-containers/s6-overlay works
s6-overlay is a container init and process-supervision overlay. The documented workflow begins when a container starts /init: initialization prepares the supervision tree, then user initialization tasks and dependency-ordered services run; logging and orderly shutdown support the container lifecycle. The tree provides paths for these components, but no source excerpts were supplied, so edges below rely on README statements; implementation details beyond those statements are left out.
Main entry points: services-up Service runtime · init Init entrypoint · rc.init Init stages · preinit Init setup
Components 13
Container init
- Init entrypoint
layout/rootfs-overlay/init - Init setup
layout/rootfs-overlay/package/admin/s6-overlay-@VERSION@/libexec/preinit - Init stages
layout/rootfs-overlay/package/admin/s6-overlay-@VERSION@/etc/s6-linux-init/skel/rc.init - Ownership setup
layout/rootfs-overlay/package/admin/s6-overlay-@VERSION@/libexec/fix-attrs
Service lifecycle
- Init tasks
layout/rootfs-overlay/package/admin/s6-overlay-@VERSION@/etc/s6-rc/scripts/cont-init - Finish tasks
layout/rootfs-overlay/package/admin/s6-overlay-@VERSION@/etc/s6-rc/scripts/cont-finish - Service definitions
layout/rootfs-overlay/etc/s6-overlay/user-bundles.d/user - Service runtime
layout/rootfs-overlay/package/admin/s6-overlay-@VERSION@/etc/s6-rc/scripts/services-up - User services
Runtime utilities
- Log rotation
layout/rootfs-overlay/package/admin/s6-overlay-@VERSION@/libexec/logutil-service-main - Runtime commands
layout/rootfs-overlay/command
Optional integrations
- Syslog integration
layout/syslogd-overlay/etc/s6-overlay/s6-rc.d/syslogd
Other components
- Container image
Connections 10
- Container image → Init entrypoint: starts
README.md - Init entrypoint → Init setup: prepares
README.md - Init entrypoint → Init stages: launches stages
README.md - Init stages → Init tasks: runs initialization
README.md - Init stages → Service runtime: starts supervision
README.md - Service definitions → Service runtime: declares services
README.md - Service runtime → User services: supervises
README.md - Service runtime → Finish tasks: runs finalization
README.md - Init setup → Ownership setup: sets ownership
- Service runtime → Log rotation: uses for logs
README.md