Environment Setup #

Configure your local development environment.

Docker Setup #

We use Docker for local development to ensure consistency across environments.

Install Docker #

Download and install Docker Desktop for your operating system.

Verify Installation #

docker --version
docker-compose --version

Project Setup #

Clone the main repository:

git clone git@github.com:albrightlabs/main-app.git
cd main-app

Copy the environment file:

cp .env.example .env

Start the development environment:

docker-compose up -d

Database Setup #

Run migrations:

docker-compose exec app php artisan migrate

Seed the database with test data:

docker-compose exec app php artisan db:seed

Accessing the Application #

Service URL
Web App http://localhost:8080
API http://localhost:8080/api
Database localhost:5432
Redis localhost:6379

Troubleshooting #

Port already in use #

If you see a port conflict error:

# Find what's using the port
lsof -i :8080

# Kill the process or change the port in docker-compose.yml

Container won't start #

Try rebuilding the containers:

docker-compose down
docker-compose build --no-cache
docker-compose up -d

Next Steps #