Portable Engine Nginx + PHP-FPM Per-project isolation

Local dev environment
with pit-lane speed.

PIT is a developer-first stack manager: run Nginx, PHP-FPM, and tools with clean process control, predictable ports/sockets, and project-first routing. Built to feel like an F1 pit stop: minimal downtime.

Goal
Predictable runtime
Ports, sockets, logs stay stable.
Focus
Process hygiene
No zombies, clean shutdown.
Style
Red pit-lane UI
Minimal, fast, sharp.
pit / engine
$ pit up
 nginx        started   :80
 php-fpm      started   unix:/runtime/php/php-fpm.sock
 tools pool   ready     unix:/runtime/_tools/php/php-fpm.sock

$ pit projects
 laravel-app    laravel-app.test
 ci4-panel      ci4-panel.test

$ pit down
 stopped cleanly (no zombie processes)

Features

The core stuff PIT is obsessed with.

Nginx + PHP-FPM orchestration

Start/stop services cleanly, keep logs structured, and avoid zombie processes.

CONTROL
PID control Health checks Logs
Project-first routing

Map projects to virtual hosts quickly, keep configs stable, and reduce “where is it pointing?” pain.

ROUTE
Auto vhost .test domains Isolation
Tooling sandbox

Run internal tools under a dedicated runtime folder, separate from project pools.

TOOLS
/runtime/_tools Socket separation Cleaner shutdown
Portable by default

No system-wide mess. Keep everything self-contained and reproducible.

PORTABLE
Self-contained Versioned bins Predictable paths

Pit-lane workflow

Short, strict, repeatable.

TELEMETRY
  1. 01
    Start engine

    Boot services with consistent sockets and logs.

  2. 02
    Load projects

    Route vhosts and isolate configs per project.

  3. 03
    Control & iterate

    Restart cleanly, avoid port chaos, keep momentum.

Ready to run PIT?

Jump into docs for install, commands, and architecture.