LocalDevStack Documentation

LocalDevStack is a modular, Docker-based local development stack designed to replace traditional local bundles (XAMPP/MAMP/LAMP) with a reproducible, profile-driven setup.

It is built around a small orchestrator (the lds CLI + Compose profiles) and a set of purpose-built images that work together (tools, HTTP, runner).

Getting Started

• Getting Started
  • Prerequisites
  • Quick Start
  • Directory Structure
  • Run the server (the easy way)
  • Usage
  • Next steps

Concepts

• Architecture
  • Key idea
  • How containers cooperate
• Profiles and Environment
  • Setting up Environment usable by Your Projects
  • Guided setup for on demands services (DB, Cache)
  • Manual setup (Don’t use unless you are fully aware of internals)
• Storage Layout
  • Directories
  • Why this matters

Guides

• Domain Setup
  • How lds setup domain works
  • Wizard flow (what the user answers)
  • What it generates
  • Tips
• TLS and Certificates
  • Generated files (host)
  • Domain discovery
  • Trusting the Root CA
  • Mutual TLS (Client certificates)
  • Uninstalling the Root CA
  • Troubleshooting
• Secrets with SOPS and Age
  • Typical workflow (high level)
  • Safety notes
• Notifications
  • Host usage (non-Windows)
  • From inside containers (docknotify)
  • Common pattern
  • Message format
  • PHP example: forward all PHP errors to notifications
  • Node.js example: send notifications using docknotify
  • Practical workflow