Repository navigation
v3.8.1
Cbox Init v3.8.1
Production-grade PID 1 process manager for Docker containers with Laravel-first design.
Features
- Multi-process orchestration with DAG-based dependencies
- Health checks (TCP, HTTP, Exec) with configurable thresholds
- Restart policies with exponential backoff
- Prometheus metrics export
- Management REST API with authentication
- Framework detection (Laravel, Symfony, WordPress)
- Graceful shutdown and zombie reaping
- Process scaling support
Installation
Linux AMD64
wget https://github.com/cboxdk/init/releases/download/v3.8.1/cbox-init-linux-amd64
chmod +x cbox-init-linux-amd64
sudo mv cbox-init-linux-amd64 /usr/local/bin/cbox-initLinux ARM64
wget https://github.com/cboxdk/init/releases/download/v3.8.1/cbox-init-linux-arm64
chmod +x cbox-init-linux-arm64
sudo mv cbox-init-linux-arm64 /usr/local/bin/cbox-initmacOS AMD64 (Intel)
wget https://github.com/cboxdk/init/releases/download/v3.8.1/cbox-init-darwin-amd64
chmod +x cbox-init-darwin-amd64
sudo mv cbox-init-darwin-amd64 /usr/local/bin/cbox-initmacOS ARM64 (Apple Silicon)
wget https://github.com/cboxdk/init/releases/download/v3.8.1/cbox-init-darwin-arm64
chmod +x cbox-init-darwin-arm64
sudo mv cbox-init-darwin-arm64 /usr/local/bin/cbox-initVerification
Verify the checksums:
wget https://github.com/cboxdk/init/releases/download/v3.8.1/checksums.txt
sha256sum -c checksums.txtDocker
Multi-arch images (linux/amd64, linux/arm64) on GitHub Container Registry,
tagged 3.8.1, 3.8, 3 and latest — without a v:
docker pull ghcr.io/cboxdk/init:3.8.1The image is Alpine with cbox-init as its entrypoint, running as the non-root
user cbox (uid 1000). Use it as a base:
FROM ghcr.io/cboxdk/init:3.8.1
COPY cbox-init.yaml /etc/cbox-init/cbox-init.yamlOr copy the binary into your own image — the right architecture is picked
for you:
FROM your-base-image
COPY --from=ghcr.io/cboxdk/init:3.8.1 /usr/local/bin/cbox-init /usr/local/bin/cbox-init
ENTRYPOINT ["/usr/local/bin/cbox-init"]Documentation
- Getting Started
- Installation Guide
- Docker Integration
- Configuration Examples
- Prometheus Metrics
- Management API
Quick Start
Create a minimal configuration:
version: "1.0"
global:
shutdown_timeout: 30
log_level: info
processes:
php-fpm:
enabled: true
command: ["php-fpm", "-F", "-R"]
restart: alwaysRun:
cbox-init --config cbox-init.yaml