ClientKosmos · Laravel 12 + React 19 + FrankenPHP · imagen lista para Railway / docker-compose
2.4K
Ejemplo mínimo de docker-compose.yml. Incluye un servicio init que aplica migraciones y seeders una sola vez por deploy, y un worker que reusa la misma imagen para procesar la cola (sin él, los emails de verificación, recordatorios y transcripciones se quedan encolados sin consumirse).
services:
init:
image: samue45/client-kosmos:latest
restart: "no"
environment:
CONTAINER_ROLE: init
APP_NAME: ClientKosmos
APP_ENV: production
APP_KEY: base64:REEMPLAZA_ESTO # generar con: docker run --rm samue45/client-kosmos:latest php artisan key:generate --show
APP_URL: https://tu-dominio.example
DB_CONNECTION: mysql
DB_HOST: db
DB_PORT: "3306"
DB_DATABASE: clientkosmos
DB_USERNAME: clientkosmos
DB_PASSWORD: changeme
depends_on:
db:
condition: service_healthy
app:
image: samue45/client-kosmos:latest
ports:
- "8000:8000"
environment:
CONTAINER_ROLE: web
SKIP_DB_BOOTSTRAP: "1" # el servicio `init` ya migró
APP_NAME: ClientKosmos
APP_ENV: production
APP_DEBUG: "false"
APP_KEY: base64:REEMPLAZA_ESTO # MISMO valor en todos los servicios
APP_URL: https://tu-dominio.example
ASSET_URL: https://tu-dominio.example
TRUSTED_PROXIES: "*"
DB_CONNECTION: mysql
DB_HOST: db
DB_PORT: "3306"
DB_DATABASE: clientkosmos
DB_USERNAME: clientkosmos
DB_PASSWORD: changeme
SESSION_DRIVER: database
CACHE_STORE: database
QUEUE_CONNECTION: database
BROADCAST_CONNECTION: "null"
LOG_CHANNEL: stderr
MAIL_MAILER: log
volumes:
- clientkosmos_storage:/app/storage/app
depends_on:
init:
condition: service_completed_successfully
db:
condition: service_healthy
worker:
image: samue45/client-kosmos:latest
restart: on-failure
environment:
CONTAINER_ROLE: queue # arranca `queue:work` en vez de FrankenPHP
APP_NAME: ClientKosmos
APP_ENV: production
APP_KEY: base64:REEMPLAZA_ESTO # MISMO valor que en `app`
APP_URL: https://tu-dominio.example
DB_CONNECTION: mysql
DB_HOST: db
DB_PORT: "3306"
DB_DATABASE: clientkosmos
DB_USERNAME: clientkosmos
DB_PASSWORD: changeme
SESSION_DRIVER: database
CACHE_STORE: database
QUEUE_CONNECTION: database
LOG_CHANNEL: stderr
MAIL_MAILER: log
volumes:
- clientkosmos_storage:/app/storage/app
depends_on:
init:
condition: service_completed_successfully
db:
condition: service_healthy
db:
image: mysql:8.0
environment:
MYSQL_DATABASE: clientkosmos
MYSQL_USER: clientkosmos
MYSQL_PASSWORD: changeme
MYSQL_ROOT_PASSWORD: rootchangeme
volumes:
- clientkosmos_dbdata:/var/lib/mysql
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
interval: 5s
retries: 10
volumes:
clientkosmos_storage:
clientkosmos_dbdata:
Genera primero la APP_KEY y pégala en los tres servicios:
docker run --rm --entrypoint php samue45/client-kosmos:latest artisan key:generate --show
docker compose up -d
docker compose logs -f app
Abre http://localhost:8000.
Variante de un solo servicio: si prefieres no tener
initaparte, omítelo y deja queapphaga el bootstrap (es el comportamiento por defecto cuandoSKIP_DB_BOOTSTRAPno está fijado a1). El servicioinitse recomienda solo para deploys multi-servicio (Railway, K8s) donde quieres aislar migraciones del runtime HTTP.
APP_KEY: en
APP_ENV=productionel entrypoint falla rápido si está vacía (no la autogenera, porque regenerarla invalida sesiones y cookies firmadas). En desarrollo (APP_ENV=local) sí se genera una efímera y se avisa por logs.
Si APP_ENV no es production y la tabla users está vacía, el entrypoint ejecuta los seeders de demo automáticamente. En producción nunca se siembran datos demo, solo RoleSeeder y PermissionSeeder (idempotentes).
Para desarrollo local con email: añade
axllent/mailpit:latestexponiendo1025:1025(SMTP) y8025:8025(UI). ApuntaMAIL_MAILER=smtp+MAIL_HOST=mailpit+MAIL_PORT=1025enappyworker. Lee los emails capturados enhttp://localhost:8025.
| Password | Rol | |
|---|---|---|
[email protected] | password | admin |
[email protected] | password | profesional |
| Clave | Descripción |
|---|---|
APP_KEY | Clave de cifrado de Laravel. Genera con docker run --rm samue45/client-kosmos:latest php artisan key:generate --show y fíjala. En APP_ENV=production el entrypoint falla si está vacía. |
APP_URL / ASSET_URL | URL pública absoluta (con https://). Wayfinder e Inertia generan URLs a partir de ella. |
DB_* | DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD. Probado con MySQL 8.0 y 8.4. |
APP_ENV=productionAPP_DEBUG=falseTRUSTED_PROXIES=* si hay un reverse proxy delante (Railway, Traefik, Nginx)SESSION_DRIVER=databaseCACHE_STORE=databaseQUEUE_CONNECTION=databaseBROADCAST_CONNECTION=null (por defecto; ver sección Reverb más abajo)LOG_CHANNEL=stderrPORT=8000 si tu plataforma usa esa variable para health checks| Funcionalidad | Variables |
|---|---|
| Despliegue multi-servicio | CONTAINER_ROLE=init|web|queue|scheduler|reverb (default web) |
Saltar bootstrap en web | SKIP_DB_BOOTSTRAP=1 (usado cuando hay un servicio init separado) |
| Pagos con Stripe Checkout | STRIPE_KEY, STRIPE_SECRET, STRIPE_WEBHOOK_SECRET |
| Google OAuth + Calendar/Meet | GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REDIRECT_URI |
| Asistente Kosmo (LLM) | GROQ_API_KEY, GROQ_BASE_URL, GROQ_MODEL |
| Transcripción Whisper / OpenAI | OPENAI_API_KEY, OPENAI_ORGANIZATION |
| Email vía SMTP (Brevo recomendado) | MAIL_MAILER=smtp, MAIL_HOST=smtp-relay.brevo.com, MAIL_PORT=587, MAIL_USERNAME, MAIL_PASSWORD, MAIL_ENCRYPTION=tls, MAIL_FROM_ADDRESS |
| Email vía Resend (HTTP API) | MAIL_MAILER=resend, RESEND_API_KEY, MAIL_FROM_ADDRESS (requiere dominio verificado en Resend) |
| Object storage (Cloudflare R2 / S3) | FILESYSTEM_DISK=s3, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION, AWS_BUCKET, AWS_ENDPOINT (R2), AWS_USE_PATH_STYLE_ENDPOINT=true |
| WebSockets / live updates | BROADCAST_CONNECTION=reverb, REVERB_APP_ID, REVERB_APP_KEY, REVERB_APP_SECRET, REVERB_HOST, REVERB_PORT, REVERB_SCHEME |
Email en producción: la configuración estable es Brevo SMTP (free tier 300 emails/día, basta verificar un sender — no requiere dominio propio). Railway bloquea egreso SMTP por defecto, así que en Railway concretamente el transport activo es Brevo SMTP con sender verificado. Si tienes dominio propio puedes conmutar a Resend con el transport
resend. Las notificaciones de verificación y reset de contraseña están encoladas (QueuedVerifyEmail,QueuedResetPassword), así que necesitas el servicioworkerarriba para que se envíen.
Runtime inmutable: desde el último refactor, el entrypoint NO vuelca las variables del proceso al
.envinterno. Laravel resuelveenv()leyendo$_SERVER/$_ENV/getenv(), yconfig:cachecaptura los valores del proceso correctamente. No intentes editar/app/.envdentro del contenedor — no tiene efecto sobre la config cacheada.
| Ruta | Qué guarda | Obligatorio |
|---|---|---|
/app/storage/app | Subidas de usuario, documentos, transcripciones, evidencia | Sí (*) |
(*) Solo si no usas object storage. Con
FILESYSTEM_DISK=s3apuntando a Cloudflare R2 o S3, los archivos viven fuera del contenedor y no hace falta montar nada.No montes
/app/storagecompleto.framework/cache,framework/sessionsyframework/viewsdeben regenerarse en cada arranque; persistirlas puede provocar cachés obsoletas.
HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
CMD curl -f http://localhost:8000/up || exit 1
El endpoint /up (Laravel 11+) devuelve 200 cuando providers y contenedor inicializan sin errores. Es una sonda de liveness. Para una sonda de readiness más profunda (con check de BD o servicios externos), engánchate al evento Illuminate\Foundation\Events\DiagnosingHealth en bootstrap/app.php.
8000/tcp — HTTP plano (FrankenPHP). TLS lo termina el proxy externo.8080/tcp — Reverb WebSocket (solo cuando CONTAINER_ROLE=reverb; configurable con PORT).CONTAINER_ROLE)La misma imagen sirve para los cinco procesos de un despliegue Laravel típico:
| Rol | Comando que arranca | Toca la BD | Notas |
|---|---|---|---|
init | One-shot: migraciones + seeders + storage:link, luego exit 0 | Sí | Pensado para depends_on: service_completed_successfully |
web | FrankenPHP (default) | Sí si SKIP_DB_BOOTSTRAP != "1" | Si no hay init separado, se encarga del bootstrap |
queue | php artisan queue:work --tries=3 --backoff=10 --timeout=30 --sleep=3 | No | Sin --max-time / --max-jobs (Railway: ON_FAILURE no rearranca exit 0) |
scheduler | php artisan schedule:work | No | |
reverb | php artisan reverb:start --host=0.0.0.0 --port=${PORT:-8080} | No | No espera a MySQL en el boot |
Separar init del runtime HTTP evita que un fallo parcial de migración deje al web container en bucle de restart sirviendo 500s.
docker-entrypoint.sh ejecuta, en orden:
APP_ENV=production; autogenerar efímera solo en desarrollo.php artisan package:discover (composer install corrió con --no-scripts en el Dockerfile).reverb.init, o web con SKIP_DB_BOOTSTRAP != "1"):
php artisan storage:link --forcephp artisan migrate --forcedb:seed --class=RoleSeeder y --class=PermissionSeeder (idempotentes, siempre)APP_ENV ≠ production y users está vacía → db:seed de demoAPP_ENV=production (lee env del proceso, no del .env).exit 0 si rol = init; en cualquier otro caso exec al proceso final (FrankenPHP, queue:work, schedule:work o reverb:start). El exec permite que SIGTERM de Docker/Railway llegue al proceso y haga shutdown limpio.Dockerfile, multi-servicio vía CONTAINER_ROLEdeploy/legacy/Runbooks:
MIT — ver LICENSE.
La imagen base dunglas/frankenphp también está bajo licencia MIT.
Content type
Image
Digest
sha256:d4202ffb5…
Size
115.3 MB
Last updated
6 months ago
docker pull samue45/client-kosmos