Skip to content

Local development environment for PHP based projects using Docker

License

Notifications You must be signed in to change notification settings

infocyph/LocalDevStack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

  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) Setup global shortcut and Permissions

On Linux/Mac,

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

On Windows,

./lds setup permissions

Once ran, it will add a globally available shortcut (lds). And necessary permissions(linux/mac) will be assigned as well.

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

CLI help (built-in “man”)

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

Documentation

This README stays intentionally short.


License

MIT