# Yerd - Local PHP development environment for macOS & Linux

> A fast, rootless, open-source local PHP development environment for macOS and Linux. Serve .test sites over HTTP and HTTPS, run a different PHP version per site, and manage databases, mail, and tooling from one tiny daemon - a Laravel Herd alternative.

Serve your projects on .test domains over HTTP and HTTPS, run a different PHP version per site, and manage it all from one tiny daemon. No Docker, no sudo for everyday work, no subscription.

## Table of Contents

### Introduction

- [What is Yerd?](https://yerd.app/guide/introduction.md)
- [Getting Started](https://yerd.app/guide/getting-started.md): Install the Yerd desktop app and use its first-run onboarding journey to get from a clean machine to your first site live at https://my-app.test.
- [Guides](https://yerd.app/guide/guides.md): Short video walkthroughs of installing Yerd, setting up services and tooling, and creating your first Laravel site.
- [Switching to Yerd](https://yerd.app/guide/switching-to-yerd.md): A step-by-step guide to switching to Yerd from Laravel Herd, Valet, or Lerd - stop the other tool's services first, elevate Yerd, verify, and how to switch back cleanly.
- [Upgrade Guide](https://yerd.app/guide/upgrading-from-v1.md)
- [Features](https://yerd.app/guide/desktop-app.md): A tour of the Yerd desktop app, screen by screen - the recommended way to install and run Yerd, a fast, rootless, open-source local PHP environment for macOS and Linux.

### Using Yerd

- [Sites](https://yerd.app/guide/sites.md)
- [Reverse Proxies](https://yerd.app/guide/proxies.md)
- [PHP Versions](https://yerd.app/guide/php-versions.md)
- [Code Coverage](https://yerd.app/guide/code-coverage.md)
- [Tooling](https://yerd.app/guide/tooling.md)
- [Services & Databases](https://yerd.app/guide/services.md)
- [Mail Capture](https://yerd.app/guide/mail.md)
- [Laravel Dumps](https://yerd.app/guide/laravel-dumps.md)
- [AI Agents](https://yerd.app/guide/ai-agents.md)
- [Sharing Sites](https://yerd.app/guide/sharing.md)
- [HTTPS & Certificates](https://yerd.app/guide/https.md)
- [DNS & .test Domains](https://yerd.app/guide/dns.md)
- [Elevation & Privileges](https://yerd.app/guide/elevation.md)
- [Localhost Access](https://yerd.app/guide/localhost-access.md)
- [The Daemon](https://yerd.app/guide/daemon.md)
- [Diagnostics](https://yerd.app/guide/diagnostics.md)

### CLI Reference

- [CLI Reference](https://yerd.app/reference/cli.md)
- [Sites](https://yerd.app/reference/cli/sites.md)
- [Domains](https://yerd.app/reference/cli/domains.md)
- [Proxies](https://yerd.app/reference/cli/proxies.md)
- [HTTPS](https://yerd.app/reference/cli/https.md)
- [PHP](https://yerd.app/reference/cli/php.md)
- [Coverage](https://yerd.app/reference/cli/coverage.md)
- [Tooling](https://yerd.app/reference/cli/tooling.md)
- [Services](https://yerd.app/reference/cli/services.md)
- [Databases](https://yerd.app/reference/cli/db.md)
- [Mail](https://yerd.app/reference/cli/mail.md)
- [MCP](https://yerd.app/reference/cli/mcp.md)
- [LAN sharing ](https://yerd.app/reference/cli/lan.md)
- [Tunnel](https://yerd.app/reference/cli/tunnel.md)
- [Status & Diagnostics](https://yerd.app/reference/cli/diagnostics.md)
- [Elevation](https://yerd.app/reference/cli/elevation.md)
- [Daemon control](https://yerd.app/reference/cli/daemon.md)
- [Self-Update](https://yerd.app/reference/cli/update.md)
- [Uninstall](https://yerd.app/reference/cli/uninstall.md)

### Configuration

- [Configuration Reference](https://yerd.app/reference/configuration.md)

### Overview

- [Architecture](https://yerd.app/developer/architecture.md)
- [Crates Overview](https://yerd.app/developer/crates.md)
- [Building from Source](https://yerd.app/developer/building.md)
- [Contributing](https://yerd.app/developer/contributing.md)

### Internals

- [IPC Protocol](https://yerd.app/developer/ipc-protocol.md)
- [Dev-tool installer subsystem](https://yerd.app/developer/dev-tools.md)
- [Cross-Platform Model](https://yerd.app/developer/cross-platform.md)
- [Config schema history](https://yerd.app/developer/config-schema-history.md)

### Crates

- [yerd-core](https://yerd.app/developer/crates/yerd-core.md)
- [yerd-ipc](https://yerd.app/developer/crates/yerd-ipc.md)
- [yerd-config](https://yerd.app/developer/crates/yerd-config.md)
- [yerd-tls](https://yerd.app/developer/crates/yerd-tls.md)
- [yerd-dns](https://yerd.app/developer/crates/yerd-dns.md)
- [yerd-proxy](https://yerd.app/developer/crates/yerd-proxy.md)
- [yerd-supervise](https://yerd.app/developer/crates/yerd-supervise.md)
- [yerd-php](https://yerd.app/developer/crates/yerd-php.md)
- [yerd-mail](https://yerd.app/developer/crates/yerd-mail.md)
- [yerd-mcp](https://yerd.app/developer/crates/yerd-mcp.md)
- [yerd-tunnel](https://yerd.app/developer/crates/yerd-tunnel.md)
- [yerd-services](https://yerd.app/developer/crates/yerd-services.md)
- [yerd-doctor](https://yerd.app/developer/crates/yerd-doctor.md)
- [yerd-platform](https://yerd.app/developer/crates/yerd-platform.md)
- [yerd-service-ctl](https://yerd.app/developer/crates/yerd-service-ctl.md)
- [yerd-update](https://yerd.app/developer/crates/yerd-update.md)
- [yerd-depcheck](https://yerd.app/developer/crates/yerd-depcheck.md)

### Binaries

- [yerdd (daemon)](https://yerd.app/developer/binaries/yerdd.md)
- [yerd (CLI)](https://yerd.app/developer/binaries/yerd.md)
- [yerd-helper (privileged)](https://yerd.app/developer/binaries/yerd-helper.md)

### App & Tooling

- [Desktop App Internals](https://yerd.app/developer/gui.md)
- [Build Automation (xtask)](https://yerd.app/developer/xtask.md)