Skip to content
@lerd-env

Lerd

Open source local PHP development environment for Linux and macOS

Lerd

Local PHP development that just works. Run lerd link and your project is live at project.test with HTTPS. No Docker, no sudo, no system pollution.

Docs Reddit Discord

Open-source, Herd-like local PHP development for Linux and macOS, with Windows via WSL2 (beta). Nginx, PHP-FPM, and your services run as rootless Podman containers, fronted by a built-in Web UI, a btop-style terminal dashboard, a full CLI, and an MCP server so your AI assistant can drive the whole thing from chat.

curl -fsSL https://lerd.sh/install.sh | bash

Works with Laravel, Symfony, WordPress, Drupal, CakePHP, Statamic, and any custom PHP framework.

Why Lerd

Lerd DDEV Lando Laravel Herd
Podman-native 🟡
Rootless
Web UI
Terminal dashboard
Linux
macOS
Windows (WSL2) 🧪
MCP server

What you get

  • 🌐 Automatic .test domains with one-command TLS, or opt out and use *.localhost with no system resolver tweak
  • 🐘 Per-project PHP (8.1 to 8.5) switched with one click, plus a per-site FrankenPHP runtime with Laravel Octane and Symfony Runtime
  • 🖥️ Built-in Web UI with live dashboards, a Cmd+K command palette, in-browser editing of nginx, php.ini, and .env, and fourteen languages
  • 🛰️ Debug window that streams every dump() and dd() to the dashboard, plus SQL with N+1 and slow-query detection, mail, jobs, events, and outgoing HTTP, on Laravel and Symfony
  • 🔥 SPX profiler — one click turns every request into a flame graph, no FPM restart and no code changes
  • 🩺 Site doctor with framework-agnostic health checks and one-click fixes, in the UI, the TUI, the CLI, and MCP
  • 📈 Request timing that charts response times and the slowest routes from your site's own traffic, with a click to profile the route that stands out
  • 🐚 Tinker in the browser, a REPL against your running application, and a terminal dashboard for everything you would rather not leave the shell for
  • 🗄️ One-click services: MySQL, PostgreSQL, Redis, Meilisearch, Mailpit, and more, each a versioned YAML preset you can update, migrate, or reset in place
  • 💾 Databases you can hand around: export, import, and snapshots you can roll back to, next to bucket and mail management in the same dashboard
  • Native runtime on macOS, where PHP-FPM, the CLI and the workers run on the host instead of crossing the VM boundary for every file
  • 📶 Share a site over the LAN with your phone or a colleague's laptop, loopback URLs in the page rewritten so the other device can follow them
  • 🔔 Desktop notifications and a system tray for failed jobs, slow routes, captured mail and the environment's state, without a tab open
  • 😴 Idle-suspend, which stops a quiet site's workers and brings them back on the next request, so a machine full of projects costs what you are actually using
  • 🌳 First-class git worktrees with auto-detected branch domains, per-worktree PHP and Node versions, and optional database isolation
  • 🤖 MCP server so Claude Code, Cursor, Copilot, and other assistants scaffold projects, run migrations, and manage services from chat
  • 🔒 Rootless and daemonless, Podman-native, no Docker required, dual-stack IPv4 and IPv6

Repositories

lerd-env is the home for Lerd's community and distribution repos.

  • lerd, the main project: the CLI, the Web UI, the MCP server, and everything else.
  • lerd-desktop, the desktop app: a native window around the dashboard with native desktop notifications, shipped as a Flatpak, pairing with Lerd running on your machine.
  • lerd-omarchy-glance, the Omarchy bar widget: sites, services, workers and container resources in the Quattro bar, quiet until something breaks, so the state of the environment is on screen without opening a tab.
  • frameworks, the community framework store. Every lerd link pulls a matching definition from here, so a new PHP framework gains full support by editing YAML, no Lerd release required.
  • services, the community service-preset store. Databases, caches, search engines, and admin dashboards, all as versioned YAML that ships without a binary release.
  • lerd-nixos, the NixOS flake. Packages the binary and ships the configuration.nix blocks the stack needs to run Lerd declaratively.
  • php, the static PHP builds behind the native runtime on macOS: an interpreter per supported version, for sites served straight on the host rather than in a container.
  • homebrew-lerd, the Homebrew tap, for brew install lerd-env/lerd/lerd on macOS and Linux.
  • lerd-deb, the Debian and Ubuntu packaging, published to the ppa:lerd/lerd Launchpad PPA.
  • lerd-rpm, the Fedora packaging, published to COPR.

Get involved

Read the docs at lerd.sh, join the community on Discord and r/lerd, and open a pull request. Adding a framework to the store is the easiest place to start.

Pinned Loading

  1. lerd lerd Public

    Open-source, Herd-like local PHP development environment for Linux and macOS. Automatic .test domains, per-project PHP/Node isolation, one-command TLS. Podman-native, rootless.

    Go 1.3k 79

Repositories

Showing 10 of 12 repositories
  • lerd-phpstorm Public

    Manage your Lerd local PHP environment from PhpStorm: site controls, logs, query findings and dumps, without a browser tab.

    lerd-env/lerd-phpstorm's past year of commit activity
    Kotlin 1 MIT 0 0 0 Updated Sep 22, 2026
  • lerd Public

    Open-source, Herd-like local PHP development environment for Linux and macOS. Automatic .test domains, per-project PHP/Node isolation, one-command TLS. Podman-native, rootless.

    lerd-env/lerd's past year of commit activity
    Go 1,315 MIT 79 8 (1 issue needs help) 1 Updated Sep 22, 2026
  • lerd-omarchy-glance Public

    Your lerd dashboard at a glance in the Omarchy Quattro bar

    lerd-env/lerd-omarchy-glance's past year of commit activity
    QML 10 MIT 1 0 0 Updated Sep 21, 2026
  • services Public

    Community service presets that power Lerd. Add a database, cache, search engine, or admin dashboard by editing YAML, no release required.

    lerd-env/services's past year of commit activity
    2 2 1 0 Updated Sep 20, 2026
  • frameworks Public

    Community framework definitions that power Lerd. Teach Lerd a new PHP framework by editing YAML, no release required.

    lerd-env/frameworks's past year of commit activity
    7 7 0 0 Updated Sep 20, 2026
  • lerd-deb Public

    Debian/Ubuntu packaging for lerd, published to the ppa:lerd/lerd Launchpad PPA

    lerd-env/lerd-deb's past year of commit activity
    Shell 1 MIT 0 0 0 Updated Sep 18, 2026
  • .github Public

    Org profile and community files for Lerd

    lerd-env/.github's past year of commit activity
    0 0 0 0 Updated Sep 18, 2026
  • lerd-rpm Public

    Fedora packaging for lerd, published to COPR

    lerd-env/lerd-rpm's past year of commit activity
    Shell 1 MIT 0 1 0 Updated Sep 17, 2026
  • lerd-nixos Public

    NixOS flake for Lerd, the Herd-like local PHP dev environment. Packages the binary and ships the configuration.nix blocks the stack needs.

    lerd-env/lerd-nixos's past year of commit activity
    Shell 4 MIT 0 0 0 Updated Sep 17, 2026
  • homebrew-lerd Public

    Homebrew tap for Lerd — local Laravel development environment

    lerd-env/homebrew-lerd's past year of commit activity
    Ruby 1 0 0 0 Updated Sep 16, 2026