vigil-s6-container-supervision

Modify and debug s6-overlay supervision trees in VIGIL Docker containers.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill vigil-s6-container-supervision
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vigil-s6-container-supervision
Source: https://github.com/Signmanal/VIGIL/tree/main/optional-skills/devops/vigil-s6-container-supervision
Command: npx skills add https://github.com/Signmanal/VIGIL --skill vigil-s6-container-supervision

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the steep learning curve and VIGIL-specific quirks of working with the s6-overlay supervision tree in Docker containers, which behaves very differently from standard Docker init systems and has unique requirements for service registration, gateway lifecycle management, and boot sequencing.

Core Features & Use Cases

  • Static Service Management: Add, remove, or modify long-running supervised services (like the VIGIL Dashboard) in the Docker image's s6-rc bundle to match your deployment needs.
  • Per-Profile Gateway Troubleshooting: Diagnose why per-profile gateways fail to start, enter crash loops, or don't survive container restarts, and adjust their run scripts to fix configuration issues.
  • Boot Sequence Customization: Modify cont-init.d boot scripts for tasks like UID remapping, volume seeding, or profile reconciliation to align with your infrastructure requirements. Use case example: If your VIGIL Docker deployment's per-profile coder gateway keeps crashing on startup, use this Skill to inspect its s6 service status, identify missing model configuration, and update the gateway run script to resolve the issue.

Quick Start

Use the vigil-s6-container-supervision skill to diagnose why your VIGIL Docker container's per-profile gateway is stuck in a crash loop after a recent configuration change.

Frequently Asked Questions about vigil-s6-container-supervision

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a per-profile gateway stuck in a crash loop in a Docker container?

To fix a per-profile gateway crash loop in a Docker container, inspect its s6 service status, identify missing configuration, and update the gateway run script to correct boot sequencing issues.

How do I add a long-running supervised service to an s6-overlay bundle?

Add a long-running supervised service to an s6-overlay bundle by modifying the Docker image's s6-rc bundle to register the service in the tmpfs service slots, ensuring proper PID 1 process management.

How does s6-overlay v3 handle PID 1 process management and container shutdown workflows?

s6-overlay v3 handles PID 1 process management by registering services in tmpfs slots and ensuring correct exit code propagation, which aligns container runtime behavior for graceful shutdown workflows.

Can I customize cont-init.d boot scripts for UID remapping and volume seeding in Docker?

Yes, you can customize cont-init.d boot scripts in Docker to perform UID remapping, volume seeding, or profile reconciliation, aligning the container initialization sequence with your infrastructure requirements.

Why do my s6-overlay supervised services fail to survive container restarts?

s6-overlay supervised services fail to survive container restarts when service registration in the s6-rc bundle or run script configuration is incorrect, preventing proper lifecycle management during boot sequencing.