A high-performance drop-in replacement for the OpenRuntimes Executor, rebuilt from the ground up in Rust.

URT Executor provides full API compatibility with the PHP OpenRuntimes Executor while delivering improved performance through compiled Rust, with graceful shutdown, background maintenance tasks, and container health monitoring.

• Full API compatibility with OpenRuntimes Executor
• Backwards-compatible configuration (supports both URT_* and OPR_EXECUTOR_* environment variables)
• Support for v2, v4, and v5 runtime protocols
• Configurable resource minimums (CPU/memory overrides)
• Configurable request body size limits
• S3/MinIO storage support for build artifacts
• Graceful shutdown with active execution draining
• Container stats collection and caching
• Optional Prometheus /metrics exporter for Grafana/Prometheus
• Automatic inactive container cleanup

unified-runtimes/
├── crates/
│   ├── urt-core/       # Shared types and configuration
│   └── urt-executor/   # Main executor binary
└── docker/
    └── Dockerfile      # Production container image

# Clone the repository
git clone https://github.com/Unified-Projects/unified-runtimes.git
cd unified-runtimes

# Copy environment template
cp .env.example .env

# Edit .env and set URT_SECRET to a secure value
vim .env

# Start the executor
docker compose up -d

# Check health
curl http://localhost:9900/v1/health

# Build release binary
cargo build --release --package urt-executor

# Run
URT_SECRET=your-secret ./target/release/urt-executor

docker build -f docker/Dockerfile -t urt-executor .
docker run -d \
  -p 9900:80 \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -e URT_SECRET=your-secret \
  urt-executor

All configuration is via environment variables. URT variables take priority over legacy OPR_EXECUTOR variables.

See .env.example for the complete list with descriptions.

• GET /v1/health - OpenRuntimes-compatible text health check (OK)
• GET /v1/health/stats - Enhanced JSON health stats (optional)
• GET /v1/ping - Lightweight ping check

• GET /metrics - Prometheus metrics (enabled only when URT_METRICS=true)
  • When URT_SECRET is set, provide Authorization: Bearer <secret>

• POST /v1/runtimes - Create a new runtime
• GET /v1/runtimes - List all runtimes
• GET /v1/runtimes/{id} - Get runtime details
• DELETE /v1/runtimes/{id} - Delete a runtime

• POST /v1/runtimes/{id}/executions - Execute a function
• POST /v1/runtimes/{id}/execution - Execute a function (alias)

• GET /v1/runtimes/{id}/logs - Stream container logs
• POST /v1/runtimes/{id}/commands - Execute shell command in container

# Run tests
cargo test

# Run with debug logging
RUST_LOG=debug cargo run --package urt-executor

# Run benchmarks
cargo bench --package urt-executor

For security issues, kindly email us at security@unifiedprojects.co.uk instead of posting a public issue on GitHub.

AGPL-3.0 - See LICENSE for details.