LerdLocal PHP development for Linux

Nginx + PHP-FPM 8.1–8.5 on rootless Podman. Drop any project in for automatic .test domains and HTTPS, no config files, no Docker daemon, no sudo. First-class on Arch, Ubuntu, Fedora, and Debian; macOS supported too.

Get Started

View on GitHub

🤖

AI integration (MCP)

Built-in Model Context Protocol server. Claude Code, Cursor, Windsurf, and JetBrains Junie can scaffold projects, run migrations, manage services, and tail logs, all from chat.

📦

Rootless Podman

No Docker daemon, no sudo for containers, no system pollution. All services run as your user via rootless Podman and systemd user units, on Arch, Ubuntu, Fedora, and Debian (and macOS via Homebrew).

🌐

Auto .test domains

Every linked project gets a .test domain instantly, with dual-stack IPv4 and IPv6, no /etc/hosts edits, no DNS setup.

🐘

PHP & Node versions

PHP 8.1–8.5 and multiple Node versions side by side, switched per-project from the CLI, the Web UI, or the TUI.

🔒

One-command HTTPS

`lerd secure` issues a locally-trusted TLS cert via mkcert, rewrites the nginx vhost, and updates APP_URL for you.

⚡

FrankenPHP runtime

Per-site FrankenPHP as an alternative to shared PHP-FPM, with Laravel Octane and Symfony Runtime worker mode.

🔧

Services & presets

Built-ins (MySQL, Postgres, Redis, Meilisearch, RustFS, Mailpit), one-click presets, or any OCI image as a custom service.

🖥️

Web UI, TUI & tray

Browser dashboard with command palette, btop-style TUI (`lerd tui`), and a system tray applet, all wired to the same live event bus.

🧪

Tinker tab

In-browser PHP REPL per site with autocomplete, live linting, and collapsible dump trees. Works on Laravel, Symfony, and any composer-based PHP project.

🧩

Framework store

YAML framework definitions for Laravel, Symfony, WordPress, Drupal, CakePHP, and Statamic, auto-detected on `lerd link`.

🧱

Polyglot sites

Drop a `Containerfile.lerd` to run Node, Python, Ruby, or Go alongside your PHP sites, with full HTTPS and DNS.