docsfs

Lerd

Open-source Herd-like local PHP development environment for Linux and macOS. Podman-native, rootless, with a built-in Web UI.

Lerd runs Nginx, PHP-FPM, and your services as rootless Podman containers, designed for PHP developers on Linux and macOS. No Docker. No sudo. No system pollution. Just lerd link and your project is live at project.test with HTTPS.

Built for Linux PHP developers

If you're a PHP developer on Linux and want frictionless local development — automatic .test domains, per-project PHP versions, one-click HTTPS, zero Docker — Lerd is built for you. Works with Laravel, Symfony, WordPress, Drupal, CakePHP, Statamic, and any custom PHP framework.

Features

• 🌐 Automatic .test domains with one-command TLS, or opt out of lerd-managed DNS and use *.localhost (no dnsmasq, no system resolver tweak, no sudo for the DNS bits)
• 🐘 Per-project PHP version (8.1–8.5, plus a frozen 7.4 / 8.0 legacy tier for hosted-on-the-old-stack projects), switch with one click
• ⚡ FrankenPHP runtime per site as an alternative to shared PHP-FPM, with Laravel Octane and Symfony Runtime worker mode
• 📦 Node.js isolation per project (Node 22, 24)
• 🖥️ Built-in Web UI with a dashboard root, live widgets, a global Cmd+K command palette, and seven dashboard languages (English, German, Spanish, French, Indonesian, Dutch, Portuguese)
• 🧪 Tinker tab - in-browser PHP REPL per site with autocomplete (project models, composer helpers, PHP built-ins), live php -l syntax checking, and a collapsible tree view for dump() output. Works on Laravel (artisan tinker), Symfony, and any composer-based PHP project
• 🛰️ Live dump() / dd() viewer that intercepts every dump() and dd() call from your running app and streams it to the dashboard, TUI (D key), MCP, and lerd dump tail, scoped per site and per worktree branch, with the original response left clean unless you flip passthrough on
• 🔥 SPX profiler with one-click on/off, every PHP-FPM request becomes a flame graph viewable in a same-origin Profiler view in the dashboard. No FPM restart, no code changes, and lerd profile run profiles a one-shot artisan or CLI command
• 💻 Terminal dashboard (lerd tui) - btop-style TUI with live status, site detail pane, inline domain and version editing, shell drop-in, log tailing, and filter/sort — the same operations surface as the web UI, for tmux and SSH workflows
• 🗄️ One-click services: MySQL, PostgreSQL, Redis, Meilisearch, RustFS, Mailpit, Gotenberg, Stripe Mock, Reverb and more. Every default service is a YAML preset you can update, migrate, rollback, or reinstall in place, including a reset-data reinstall that auto-recreates linked sites' databases and buckets
• 🌳 First-class git worktrees with auto-detected branch domains, per-worktree PHP/Node versions, optional per-worktree database isolation (clone from main or empty), a per-worktree LAN-share proxy, env_overrides templating in .lerd.yaml for multi-tenant apps, automatic wildcard cert SANs for *.branch.site.test, a built-in Vite dev server worker that runs on the host per branch, and a dashboard modal for adding and removing worktrees without touching the CLI
• ⚒️ Worker self-heal, failed queue, schedule, horizon, reverb, and stripe workers are surfaced everywhere (CLI, dashboard banner, TUI, MCP) and recovered with one click or lerd worker heal
• 📋 Live logs for PHP-FPM, Queue, Schedule, Reverb, per site
• 🔒 Rootless & daemonless - Podman-native, no Docker required, dual-stack IPv4 + IPv6
• 🤖 MCP server - let AI assistants (Claude Code, Windsurf, Junie) manage your environment directly
• 🧩 Framework store - community definitions for Laravel, Symfony, WordPress, Drupal, CakePHP, Statamic with versioned auto-detection
• ⚡ Framework-agnostic workers, env setup, and nginx proxy — driven by YAML definitions, not hardcoded

AI Integration (MCP)

Lerd ships a built-in Model Context Protocol server. Connect it to Claude Code, Windsurf, JetBrains Junie, or any MCP-compatible AI assistant and manage your dev environment without leaving the chat.

lerd mcp:enable-global   # register once, works in every project

Then just ask:

You: set up the project I just cloned
AI:  → site_link()
     → composer install
     → env_setup()    # detects MySQL + Redis, starts them, creates DB, generates APP_KEY
     → setup()        # storage:link + migrate for Laravel, doctrine:migrations:migrate for Symfony
     ✓  myapp → https://myapp.test ready

~50 tools available: scaffold new projects, run migrations, manage services, toggle workers, tail logs, enable Xdebug, manage databases, manage PHP extensions, park directories, switch runtimes between PHP-FPM and FrankenPHP, and more, all from your AI assistant.

📖 MCP documentation

Why Lerd?

🟡 DDEV runs on Docker by default and can also use Podman as an alternative runtime; Lerd is built exclusively for rootless Podman.

Install

Linux

curl -fsSL https://raw.githubusercontent.com/geodro/lerd/main/install.sh | bash

Update later with:

lerd update

macOS

Install via Homebrew:

brew install geodro/lerd/lerd
lerd install

Update later with:

brew upgrade lerd
lerd install

[!NOTE] See the installation docs for details.

Quick Start

cd my-laravel-project
lerd link
# → https://my-laravel-project.test

lerd install already starts everything for you on first run, so you can lerd link immediately. Day-to-day:

lerd start          # boot DNS, nginx, PHP-FPM, services, workers, UI
lerd stop           # stop containers and workers (UI and watcher stay up)
lerd quit           # full shutdown including UI, watcher, and tray
lerd autostart enable   # boot lerd on every login
lerd status         # health snapshot

See Start, Stop & Autostart for the full lifecycle reference.

Framework Store

Install community framework definitions from geodro/lerd-frameworks:

lerd framework search                   # list all available
lerd framework install symfony          # auto-detects version from composer.lock
lerd framework install drupal@11        # explicit version
lerd framework list --check             # compare local vs store

Frameworks auto-detect when you lerd link a project. Workers, env setup, nginx proxy, and setup commands are all driven by the framework definition — no hardcoded behavior.

Documentation

📖 geodro.github.io/lerd

• Requirements
• Installation
• Quick Start
• Start, Stop & Autostart
• Frameworks
• Services
• Command Reference

License

MIT