LocalDevStack

LocalDevStack provides an easy-to-use Docker-based development environment for your projects. All modules are selective and can be enabled via environment settings (Compose profiles). Supports multiple domains and local TLS (mkcert).

1. Local development only.
2. Your domain(s) must be resolvable on your host:
   • add entries to your hosts file: <your_ip> <your_domain>, or
   • use a DNS that resolves to your machine, or
   • use *.localhost (no hosts entry required in many setups)

---

Prerequisites (Docker)

Install docker on your system first. If you already have docker installed, you can skip this step.

• It is recommended to use Docker Engine.
• If Docker Engine not supported in your OS, use Docker Desktop (although you can also install this on linux as well).

---

Quickstart

1) Clone

git clone https://github.com/infocyph/LocalDevStack.git
cd LocalDevStack

2) Permissions (Linux/macOS)

chmod +x ./lds 2>/dev/null || true
sudo ./lds setup permissions

3) Start the stack

lds start

4) Add a domain (vhost wizard)

lds setup domain

5) Optional: trust HTTPS locally (Root CA)

sudo lds certificate install

6) Reload HTTP (after vhost/cert changes)

lds http reload

---

Minimal configuration

Most setups only need:

• PROJECT_DIR (where your apps live)
• COMPOSE_PROFILES (what to run)

Example:

PROJECT_DIR=../application
COMPOSE_PROFILES=nginx,php,php84,tools,mariadb,redis

---

CLI help (built-in “man”)

lds help
lds help <command>
lds help setup
lds help certificate

---

Documentation

This README stays intentionally short.

• Full documentation: Read the Docs (Sphinx docs in docs/)
• Quick reference: lds help ...

---

License

MIT