Introduction

Welcome to the Monolith starter kit. This project gives you a production-ready foundation for building Laravel applications with a preconfigured local development workflow.

Monolith is primarily targeted at developers on Linux, and developers on Windows who run their environment through WSL2. This ensures consistent tooling, shell behavior, and container performance across the team.

Docker is required to run the starter kit locally. The application services are containerized, so make sure Docker (and Docker Compose support) is installed and running before you continue with setup. In Windows you can use Docker Desktop.

Local environment setup

1. Log into https://monolith.xml.ovh and download ZIP archive with Monolith
2. Assuming that during download you named your app My App, add following entry to your hosts file: 127.0.0.1 myapp.local
3. Start all services - go to your project dir and execute ./bin/up.sh
4. Visit http://myapp.local in your browser
5. Start hacking!