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>
This commit is contained in:
137
.env.docker.example
Normal file
137
.env.docker.example
Normal file
@@ -0,0 +1,137 @@
|
||||
# ==============================================================================
|
||||
# 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
|
||||
Reference in New Issue
Block a user