Environment Configuration

Quick Start

# Clone repository
git clone https://github.com/your-org/wedissimo-api.git
cd wedissimo-api

# Copy environment file
cp .env.example .env

# Start Docker services
docker compose up -d

# Install dependencies
docker exec wedissimo-api composer install
docker exec wedissimo-api npm install

# Generate application key
docker exec wedissimo-api php artisan key:generate

# Run migrations
docker exec wedissimo-api php artisan migrate

# Seed database
docker exec wedissimo-api php artisan db:seed

# Build assets
docker exec wedissimo-api npm run build

# Import Typesense search indexes
docker exec wedissimo-api php artisan typesense:reindex --all

# Visit http://22.22.1.1 or http://localhost:2222

Note: If you're importing WordPress data, run the Typesense import after migrations complete. See Search documentation for details.

Available URLs

• Application: http://22.22.1.1 or http://localhost:2222
• Documentation: http://localhost:2222/admin/docs
• API Docs: http://localhost:2222/admin/api/documentation
• Mailpit: http://localhost:2225
• PostgreSQL: localhost:2232
• Typesense: localhost:2226
• Prometheus: http://localhost:9090
• Grafana: http://localhost:3000 (admin/admin)

Environment Variables

Key development settings:

APP_ENV=local
APP_DEBUG=true
APP_URL=http://22.22.1.1

# Docker Database
DB_CONNECTION=pgsql
DB_HOST=wedissimo-pg
DB_PORT=5432
DB_DATABASE=wedissimo_dev
DB_USERNAME=wedissimo_user
DB_PASSWORD=wedissimo_password

# Typesense
SCOUT_DRIVER=typesense
SCOUT_QUEUE=true
TYPESENSE_API_KEY=dev-key
TYPESENSE_HOST=22.22.1.15
TYPESENSE_PORT=8108
TYPESENSE_PROTOCOL=http

# Mail (Mailpit)
MAIL_MAILER=smtp
MAIL_HOST=wedissimo-mailpit
MAIL_PORT=1025

Troubleshooting

Containers won't start

# Check logs
docker compose logs

# Rebuild containers
docker compose down
docker compose up -d --build

Database connection issues

# Verify PostgreSQL is running
docker ps | grep wedissimo-pg

# Check connection
docker exec wedissimo-api php artisan tinker
>>> DB::connection()->getPdo();

Typesense connection issues

# Check Typesense health
curl http://localhost:2226/health \
  -H "X-TYPESENSE-API-KEY: your-typesense-api-key-change-in-production"

# Verify configuration
docker exec wedissimo-api php artisan tinker
>>> config('scout.driver');

# Check indexed data
curl http://localhost:2222/metrics | grep typesense_collection

See the Search Guide for detailed Typesense setup and troubleshooting.

For more details, see CLAUDE.md.