Ejecuta Orilla en local

Desde un clon del repositorio necesitas Node.js 22.12 o superior, pnpm 11, FFmpeg/FFprobe con libx264 y AAC, y Podman Compose o Docker Compose. Usa .nvmrc para la versión comprobada del proyecto. Los sitios públicos Astro requieren Node.js 22.22 o superior.

Prepara el entorno

pnpm install --frozen-lockfile
pnpm setup:local
podman-compose --env-file .local/compose.env up -d
pnpm migrate
pnpm bootstrap
pnpm bootstrap:dashboard

Con Docker, sustituye el comando de infraestructura por docker compose --env-file .local/compose.env up -d. Espera a que PostgreSQL y SeaweedFS estén disponibles antes de migrar.

bootstrap crea un espacio nuevo cada vez: ejecútalo una vez para el arranque inicial. bootstrap:dashboard conserva una cuenta existente y guarda las credenciales iniciales bajo .local/ con permisos restringidos.

Inicia los servicios

Abre una terminal por proceso, desde la raíz:

pnpm dev:api

pnpm dev:worker

pnpm dev:web

Para entregar webhooks, inicia también pnpm dev:webhooks. La API y los workers leen la configuración local generada; no cargan automáticamente un .env arbitrario.

Direcciones locales

Servicio	Dirección
Panel	http://127.0.0.1:5178
API	http://127.0.0.1:4321
Swagger de la API	http://127.0.0.1:4321/docs
Landing	http://127.0.0.1:5180 con pnpm dev:site
Documentación	http://127.0.0.1:5181 con pnpm dev:docs

Los sitios públicos se ejecutan independientemente de la API y de los workers.

Al terminar

Detén los procesos con Ctrl+C. podman-compose --env-file .local/compose.env down detiene la infraestructura y conserva los volúmenes. No añadas -v si necesitas mantener los datos.

Los archivos de .local/ contienen configuración privada y credenciales. No los incluyas en commits, capturas ni documentación pública.