Lerd 1.24.1

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Bug Fixes

• bbae794 fix(macos): recreate podman machines broken by the 1.24.0 init bug

Other

• 6b9f964 release: v1.24.1

Full Changelog: v1.24.0...v1.24.1

Lerd 1.24.0

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Features

• d8e89e7 feat(env): support unconditional framework env defaults (env.vars)
• 5ee8936 feat(horizon): opt-in horizon:listen auto-reload for development
• 5e4aa9f feat(hostproxy): auto-assign a free dev-server port
• 95de70c feat(hostproxy): drop the assets build step from worktrees
• 332c44f feat(hostproxy): point service env at loopback for host-proxy sites
• f11b47c feat(hostproxy): run non-Node dev servers directly, not through fnm
• 0542800 feat(hostproxy): show a Proxy badge for host-proxy sites
• fd59ac3 feat(hostproxy): support git worktrees
• ebfde46 feat(hostproxy): treat the dev server as the site's main process, not a worker
• 797167a feat(mcp): add Google Antigravity and stop tests touching the real Claude CLI
• 5741e56 feat(ui): dashboard toggle for Horizon auto-reload
• b7ae509 feat: add a sites overview dashboard
• f1dd9af feat: add db:move to relocate sites between same-family DB services
• 3febe1d feat: add soketi, opensearch, redisinsight and beanstalkd presets
• 80ef02e feat: gate host-proxy and inline services behind explicit consent
• c1049a1 feat: group related sites under one base domain
• 64745b3 feat: host-proxy sites for Node dev servers
• a0c9739 feat: make the Stripe webhook listener work for any project type
• 7bda318 feat: redesign services dashboard with categorized discovery

Bug Fixes

• 856ef56 fix(debug): separate debug window events by worktree
• 5483c51 fix(env): run key generation via the framework console, not hardcoded artisan
• a32ba13 fix(horizon): honour reload across restarts, surface the chokidar prerequisite, group the controls
• bd1c69b fix(horizon): persist reload toggle when project has no .lerd.yaml
• 8314ea2 fix(host-proxy): guard rebuild and warn about Vite allowedHosts
• bfd8418 fix(host-proxy): reserve worktree ports and tear down worker units when a site path is gone
• 5d41828 fix(hostproxy): keep the dev server out of setup's composer and orphan steps
• f7f05b4 fix(hostproxy): resolve the DB service for worktree isolation on host-proxy sites
• 307ffe9 fix(hostproxy): resolve upstream from cached hosts file, not a podman probe
• 639fa2c fix(hostproxy): tear down the dev server unit on unlink even when stopped
• e743e59 fix(podman): probe mariadb with mariadb-admin instead of mysqladmin
• 504dbdf fix(security): reject inputs that could inject systemd unit and quadlet directives
• 707bccc fix(start): auto-heal podman overlay corruption + lerd machine reset
• b7945d1 fix(start): gate overlay heal to darwin, tighten matcher, size reset VM memory
• 4e98f4c fix(start): match the container-mount overlay variant; branch-tested
• 5006d26 fix(start): rebuild stale containers in overlay heal; address review
• 5088360 fix(vite): order host worker units after the FPM container at boot
• 29ba8f6 fix(workers): stop heal notifications firing on lerd stop
• 3fb01e8 fix(worktree): sanitize dots in worktree unit names
• 38e7e3e fix: address review findings in the worker sweep and db.service sync
• c8b4f91 fix: address review findings on the host-proxy consent and migrate paths
• 2972a01 fix: drop the replaced domain from .lerd.yaml on rename and removal
• 6078dcb fix: host-proxy regressions found reviewing changes since v1.23.1
• bc73ce5 fix: host-proxy regressions in db:move, migrate, and pause
• 24a3ad7 fix: let the env editor scroll all the way to the bottom
• fac45ec fix: pre-release hardening for unit/quadlet injection, host-proxy consent, and env/db edges
• 4a880d3 fix: resolve mariadb-dump/mariadb client names at runtime in db dump/restore
• 8507de1 fix: stop a host-proxy dev server when the watcher prunes a deleted site

Other

• 164b0ae Add sorting and drag-to-reorder for the sites list
• 27c62cc Merge origin/main into feat/host-proxy-sites
• 840fbc3 Merge remote-tracking branch 'upstream/main' into fix/keygen-honour-console
• 651c24b i18n: translate the group modal, command palette/run flow, and stray labels
• 739eecf refactor(horizon): store-driven reload command, per-project opt-in
• 71da485 refactor(mcp): group the tool surface and add Codex, Gemini, and Copilot
• 6f27c78 release: v1.24.0
• df3983d style: gofmt overlay_heal doc comment; drop em dashes from this PR's additions

Full Changelog: v1.23.1...v1.24.0

Lerd 1.23.1

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Bug Fixes

• cb166bf fix(macos): pin --platform on pull for amd64-only images, register only after pull succeeds (#473)
• 53d69cc fix: admin-tool banner and install for any database version or family member

Other

• 233f7ce release: v1.23.1

Full Changelog: v1.23.0...v1.23.1

Lerd 1.23.0

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Features

• 1fb6714 feat(env): personal .env.lerd_override for per-project overrides (#469)
• 340984d feat(nginx): edit nginx config (per-site + global http-level) from the web UI (#437)
• 8e93273 feat(services): YAML-declared tuning override + service_config MCP tool (#442)
• e0f6491 feat(services): add Check for updates button on web UI (#418)
• 91624c8 feat(services): postgres runtime tuning via a config_file wrapper (#453)
• ec73498 feat(services): tuning override for the redis family (#439)
• c84ae1b feat(services): user-editable runtime tuning override for db services (#429)
• b6292aa feat(tui): full Debug window in the TUI with eight switchable lenses (#468)
• 67be185 feat(tui): system view, dashboard, modals, toasts, palette, and a polish pass (#417)
• 5d9d884 feat(ui): edit nginx config from the address bar, per worktree, on a shared edit service (#445)
• e2f70b4 feat(ui): edit per-version php.ini from the web UI (#436)
• 83fe94c feat(ui): editable .env files in the dashboard with backups and restore (#434)
• 3525aae feat(ui): install and remove PHP versions from the System page (#448)
• 2f5931b feat(ui): nginx editor parity with env tab and pre-flight validation (#440)
• 4bcb51d feat(ui): service config editor parity with env/nginx tabs and auto-rollback (#441)
• 594a8c6 feat(ui): service tuning config panel (#438)
• 8ec666d feat(ui): tabbed System pages with backup/restore for global nginx and php.ini (#443)
• 440ca67 feat(wsl): lerd wsl:setup + Windows (WSL2) guide, flag support beta (#432)
• de4b345 feat: turn the dump bridge into a full Debug window (#462)

Bug Fixes

• 23dfa62 fix(composer): raise process timeout so package:discover survives cold container boots (#450)
• 87bf4f0 fix(domain): sync .env APP_URL when primary domain changes in the UI (#435)
• 318d161 fix(macos): mount system directories to Podman machine during initial… (#458)
• a75c79a fix(nginx): raise server_names_hash_bucket_size so long worktree branch names don't break nginx (#456)
• 1b664e7 fix(services): unify installed-detection on quadlet presence (#433)
• 73e31c3 fix(start): don't flag lerd's own port owners as conflicts (#461)
• 7e0ef2a fix(ui): block cross-origin requests to the dashboard to close a CSRF/RCE vector (#447)
• 5000199 fix(ui): hide PHP-only controls on non-PHP sites, move Xdebug to a header toggle (#446)
• 697e19e fix: keep a site's custom nginx override attached across domain renames (#444)
• 080202c fix: pre-1.23 review follow-ups for config editing, notifications, and the debug window (#467)

Other

• bf8d5e7 Fix two issues from the post-1.22.1 review (#459)
• e2e7838 build: compile lerd_devtools in the base image instead of per-image (#464)
• 6b937af chore(deps): bump vitest to v4 to clear GHSA-5xrq-8626-4rwp (#466)
• 63ac7ec release: v1.23.0
• 6f7fc61 test(ui): isolate HOME in service-tuning handler tests to stop real plist writes (#454)

Full Changelog: v1.22.1...v1.23.0

Lerd 1.22.1

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Bug Fixes

• 129fd3c fix(dns): recognise legacy host-side resolver in dns:check (#426)
• 2416455 fix(install): auto-detect poisoned FPM hash via image labels (#427)
• d46e3c8 fix(install): clear error when podman is too old for network create --dns (#421)
• 153497b fix(install): rebuild PHP-FPM images when the Containerfile changes (#415)
• f259221 fix(lan): preflight DNS forwarder port before installing the unit (#424)
• f33ed6e fix(macos): heal gvproxy port forwards after a Podman Machine restart (#422)
• 17f8165 fix(macos): tray Quit actually exits and stops services (#419)
• 243f5e2 fix(nginx): preserve user edits to _default.conf across lerd start (#425)
• 645a60c fix(service): make lerd service reinstall transactional and route via preset name (#423)
• 05c74a3 fix(tui): pass bare version to update check so the banner doesn't false-fire (#416)
• bebdb71 fix: post-v1.22.0 review follow-ups (#430)

Other

• 9798b3c docs(readme): add r/lerd Reddit badge (#413)
• 7163884 release: v1.22.1 (#431)

Full Changelog: v1.22.0...v1.22.1

Lerd 1.22.0

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Features

• 1c0ecad feat(db): create, list, restore, and delete database snapshots (#404)
• 748ceae feat(dns): instant VPN reaction via rtnetlink and DNS in Recent Activity (#410)
• b6b52de feat(nginx): configurable request timeout per site and globally (#400)
• f470280 feat(profiler): SPX env passthrough and profiler UI improvements (#403)
• 69d0129 feat(services): add Typesense, Valkey, and Typesense Dashboard presets (#402)

Bug Fixes

• 70cae07 fix: MySQL readiness probe, dump bridge on legacy PHP, and PHP 7.2 image build (#405)
• 225547f fix: MySQL readiness probe, dump bridge on legacy PHP, and PHP 7.2 image build (#406)

Other

• 08e5beb release: v1.22.0 (#411)

Full Changelog: v1.22.0-beta.1...v1.22.0

Lerd 1.21.2

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Bug Fixes

• 1bd40b2 fix: MySQL readiness probe, dump bridge on legacy PHP, and PHP 7.2 image build

Other

• fa1835e release: v1.21.2

Full Changelog: v1.21.1...v1.21.2

Lerd 1.22.0-beta.1

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Features

• 7df2eed feat(dashboard): profiler, dump bridge and notification toggles in System health (#396)
• 284ee94 feat(dns): VPN-aware DNS status and automatic container DNS re-sync (#397)
• 222527d feat(init): seed the setup wizard from herd, ddev and lando config (#393)
• dd28bc7 feat(presets): postgres-pgvector preset + dynamic DB picker (#392)
• accc6bd feat(profiler): SPX profiler with a global toggle and dashboard view (#395)

Other

• 5a3d250 release: v1.22.0-beta.1 (#398)

Full Changelog: v1.21.1...v1.22.0-beta.1

Lerd 1.21.1

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Bug Fixes

• 5705fba fix(docs): wrap CustomExtensionsRuntime placeholder for VitePress (#389)

Other

• 5acab23 release: v1.21.1 (#391)

Full Changelog: v1.21.0...v1.21.1

Lerd 1.21.0

Lerd — Podman-powered local PHP dev environment for Linux & macOS.

Install on Linux

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

Or if already installed:

lerd update

Install on macOS

brew tap geodro/lerd
brew install lerd
lerd install

Or if already installed:

brew upgrade lerd
lerd install

Changelog

Features

• dcdf0ce feat(container): target field in .lerd.yaml selects a multi-stage build stage (#385)
• 2a5c789 feat(mcp): service_add accepts the init flag (#386)

Bug Fixes

• 91fc581 fix(image): restore git in the PHP-FPM runtime stage (#377)
• 193a22c fix(presets): wire catatonit as PID 1 for mysql and mariadb (#383)
• d07aafc fix(ui): close LAN-reachable endpoints via the existing gate and validate public_dir (#382)
• 3bdd649 fix(ui): notification clicks land on the right tab (#384)
• c464925 fix(workers): stop host workers from resurrecting after stop (#375) (#376)

Other

• 83c2967 chore(security): bump jwt-go, svelte, and kysely past their CVE windows (#387)
• ccf41b6 release: v1.21.0 (#388)

Full Changelog: v1.21.0-beta.1...v1.21.0