Files
website/.env.docker.example
Andrew dfdef3d7f4 feat: docker compose dev environment
Replaces the bare-metal `composer run dev` workflow with a fully
containerized 9-service stack orchestrated by docker compose. Single
command brings up the full app — three subdomains (marketing /
account / admin) reachable via Traefik with TLS, MariaDB + Valkey
+ Mailpit + Vite HMR + Horizon + scheduler all wired in.

Components:
- docker-compose.yml: traefik, app (php-fpm), web (nginx), mariadb,
  valkey, mailpit, vite, horizon, scheduler.
- docker/: Dockerfiles, nginx config, entrypoint scripts.
- Makefile: convenience targets (up / down / logs / shell / migrate
  / seed / test / pint / etc).
- .env.docker.example: template for Docker-stack environment vars
  (separate from website/.env so bare-metal devs aren't disrupted).
- website/vite.config.ts: server.host / origin / hmr / cors hooks
  driven by VITE_HOST / VITE_ORIGIN / VITE_HMR_HOST so the same
  config serves both bare-metal and Docker.
- website/bootstrap/app.php: redirectGuestsTo() now uses
  request()->getScheme() so http: dev hosts don't get force-https
  redirects.
- composer.json: drops laravel/sail (replaced by this stack).
- docs/superpowers/specs/2026-04-25-docker-compose-dev-environment-design.md:
  full design spec.

Bare-metal `composer run dev` workflow stays usable for anyone who
prefers it — Docker stack reads .env.docker, doesn't fight
website/.env.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-26 22:10:53 -04:00

138 lines
4.7 KiB
Plaintext

# ==============================================================================
# EZSCALE — Docker Compose dev environment
# Copy to .env.docker and fill in third-party credentials.
# This file is loaded by app, horizon, and scheduler containers.
# ==============================================================================
APP_NAME="EZSCALE Billing"
APP_ENV=local
# APP_KEY is intentionally NOT set here. The entrypoint runs `php artisan key:generate`
# which writes the key to website/.env. If APP_KEY were defined here as empty,
# the empty env var would override the .env file value (env_file beats dotenv).
APP_DEBUG=true
APP_URL=http://ezscale.docker.localhost
APP_LOCALE=en
APP_FALLBACK_LOCALE=en
APP_FAKER_LOCALE=en_US
APP_MAINTENANCE_DRIVER=file
BCRYPT_ROUNDS=10
LOG_CHANNEL=stack
LOG_STACK=single
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
# ==============================================================================
# Database — points at the `mariadb` compose service
# ==============================================================================
DB_CONNECTION=mysql
DB_HOST=mariadb
DB_PORT=3306
DB_DATABASE=ezscale_billing
DB_USERNAME=ezscale
DB_PASSWORD=ezscale_local
DB_ROOT_PASSWORD=root
# ==============================================================================
# Cache / sessions / queues — points at the `valkey` compose service
# ==============================================================================
SESSION_DRIVER=redis
SESSION_LIFETIME=120
SESSION_ENCRYPT=false
SESSION_PATH=/
SESSION_DOMAIN=.ezscale.docker.localhost
BROADCAST_CONNECTION=log
FILESYSTEM_DISK=local
QUEUE_CONNECTION=redis
CACHE_STORE=redis
REDIS_CLIENT=phpredis
REDIS_HOST=valkey
REDIS_PASSWORD=null
REDIS_PORT=6379
# ==============================================================================
# Subdomain routing
# ==============================================================================
DOMAIN_MARKETING=ezscale.docker.localhost
DOMAIN_ACCOUNT=account.ezscale.docker.localhost
DOMAIN_ADMIN=admin.ezscale.docker.localhost
# ==============================================================================
# Mail — points at the `mailpit` compose service
# ==============================================================================
MAIL_MAILER=smtp
MAIL_SCHEME=null
MAIL_HOST=mailpit
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_FROM_ADDRESS="noreply@ezscale.cloud"
MAIL_FROM_NAME="${APP_NAME}"
# ==============================================================================
# Stripe — fill with your test-mode keys
# ==============================================================================
STRIPE_KEY=
STRIPE_SECRET=
STRIPE_WEBHOOK_SECRET=
# ==============================================================================
# PayPal — sandbox credentials
# ==============================================================================
PAYPAL_MODE=sandbox
PAYPAL_SANDBOX_CLIENT_ID=
PAYPAL_SANDBOX_CLIENT_SECRET=
# ==============================================================================
# Discord admin alerts (optional)
# ==============================================================================
DISCORD_WEBHOOK_URL=
# ==============================================================================
# Provisioning APIs — external services, fill if you need to test provisioning
# ==============================================================================
VIRTFUSION_API_URL=
VIRTFUSION_API_KEY=
PTERODACTYL_API_URL=
PTERODACTYL_API_KEY=
SYNERGYCP_API_URL=
SYNERGYCP_API_KEY=
ENHANCE_API_URL=
ENHANCE_API_KEY=
# ==============================================================================
# Screenshot Authentication (Dev/Local Only)
# ==============================================================================
SCREENSHOT_AUTH_ENABLED=false
SCREENSHOT_TOKEN=
# ==============================================================================
# Support Ticket Email Integration (IMAP) — optional
# ==============================================================================
SUPPORT_EMAIL=support@ezscale.cloud
TICKET_EMAIL_POLLING=false
IMAP_HOST=outlook.office365.com
IMAP_PORT=993
IMAP_ENCRYPTION=ssl
IMAP_USERNAME=
IMAP_PASSWORD=
IMAP_VALIDATE_CERT=true
IMAP_PROTOCOL=imap
IMAP_FOLDER=INBOX
# ==============================================================================
# ServerHunter Integration (optional)
# ==============================================================================
SERVERHUNTER_API_KEY=
# ==============================================================================
# Vite — Laravel Vite plugin reads this
# ==============================================================================
VITE_APP_NAME="${APP_NAME}"
VITE_DEV_SERVER_URL=http://vite.ezscale.docker.localhost