homebrew-lerd

Open-source Herd-like local PHP development environment, packaged as the lerd-env/lerd Homebrew tap for macOS and Linux.

Lerd runs Nginx, PHP-FPM, and your services as rootless Podman containers: automatic .test domains with HTTPS, per-project PHP versions, one-click databases and services, a built-in web UI, TUI, CLI and MCP server. No Docker, no sudo, no system pollution. This repo makes it a first-class Homebrew citizen: brew install brings up the whole stack on its own, and every update after that arrives with your normal brew upgrade.

Install

brew install lerd-env/lerd/lerd
lerd install

Recent Homebrew versions block third-party taps until you trust them; if brew asks, run brew trust lerd-env/lerd first.

On macOS the formula pulls in Podman from Homebrew automatically. On Linux, lerd integrates with the distro's Podman, so the formula deliberately does not depend on Homebrew's; lerd install tells you what to install if it is missing.

Updates arrive through brew like any other formula:

brew upgrade lerd

To uninstall cleanly, tear the stack down before removing the binary:

lerd uninstall
brew uninstall lerd

How it works

The lerd.rb formula here is not written by hand. GoReleaser generates it as part of every upstream release and pushes it to this repo: the formula points at the prebuilt per-OS, per-architecture tarballs already published on the release, pinned by sha256, and installs the lerd binary (plus lerd-tray where the tarball ships it).

Unlike lerd-deb and lerd-rpm, which poll upstream daily, this tap needs no workflow of its own: the main repo's release pipeline pushes the updated formula the moment a release goes out, so the tap is never behind. Manual edits to lerd.rb are overwritten by the next release; formula changes belong in the brews section of the main repo's .goreleaser.yaml.