Autoalojamiento de Intlayer

Intlayer puede ejecutarse completamente en tu propia infraestructura, sin necesidad de una cuenta de Intlayer Cloud. Un solo comando inicia una pila lista para producción:

curl -fsSL https://intlayer.org/install.sh | sh

El instalador descarga un docker-compose.yml y un .env, autogenera los secretos necesarios e inicia todos los contenedores con docker compose up -d.

Tabla de Contenidos

Arquitectura

                ┌─────────────────────────────┐ navegador ──────▶ │  app  (TanStack Start)  :3000│ ──┐                └─────────────────────────────┘   │ VITE_BACKEND_URL                ┌─────────────────────────────┐   │                │  backend (Fastify/Bun)  :3100│ ◀─┘                └──────────────┬──────────────┘          ┌──────────┬─────────┼──────────┬───────────┐          ▼          ▼         ▼          ▼           ▼     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium     (RS de 1 nodo)             (API de S3)     (SMTP)        (en-imagen)                             minio:9001   mailpit:8025                             (consola)    (interfaz web)

Chromium (utilizado para la generación de capturas de pantalla de Puppeteer) se incluye dentro de la imagen del backend, no se necesita un contenedor separado.

Requisitos previos

• Docker ≥ 24 y Docker Compose ≥ v2. Si falta alguno, el instalador imprimirá el enlace de instalación y saldrá.
• Puertos 3000, 3100, 8025, 9000 y 9001 disponibles en el host.
• Un host Linux o macOS (o WSL2 en Windows).

Inicio rápido

curl -fsSL https://intlayer.org/install.sh | sh

Lo que hace el instalador:

1. Verifica que docker y docker compose estén presentes.
2. Descarga docker-compose.yml y .env.example en ./intlayer/.
3. Si no existe un .env, copia el ejemplo y genera secretos aleatorios para BETTER_AUTH_SECRET, S3_ACCESS_KEY_ID y S3_SECRET_ACCESS_KEY a través de openssl rand.
4. Ejecuta docker compose pull + docker compose up -d.
5. Imprime las URLs: dashboard :3000, API :3100, interfaz de usuario de correo electrónico :8025, consola de MinIO :9001.

Una vez que la pila esté en funcionamiento, abre http://localhost:3000 y crea tu primera cuenta.

Servicios

Los puertos internos (mongo, redis) no se exponen al host por defecto.

El puerto 9000 de MinIO debe ser accesible desde el navegador porque los activos cargados (avatares, capturas de pantalla) se cargan directamente desde S3_PUBLIC_URL=http://localhost:9000/intlayer.

Variables de entorno

El instalador genera un archivo .env listo para usar. La siguiente tabla describe cada variable.

Requeridas (autogeneradas o solicitadas)

Opcionales (las características se degradan elegantemente cuando están ausentes)

Conectando tu proyecto Intlayer

Una vez que la pila esté en funcionamiento, apunta tu proyecto al backend y dashboard autoalojados en lugar de intlayer.org.

Configuración del proyecto

import type { IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  editor: {
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,

    /**
     * URL del dashboard CMS autoalojado.
     * Por defecto: https://app.intlayer.org
     */
    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000

    /**
     * URL de la API del backend autoalojado.
     * Por defecto: https://back.intlayer.org
     */
    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
  },
};

export default config;

Establece las variables de entorno en el .env de tu proyecto:

INTLAYER_CMS_URL=http://localhost:3000INTLAYER_BACKEND_URL=http://localhost:3100INTLAYER_CLIENT_ID=<your-client-id>INTLAYER_CLIENT_SECRET=<your-client-secret>

Crea credenciales de acceso en tu dashboard autoalojado en Proyectos → Claves de acceso en http://localhost:3000/projects.

SDK de @intlayer/api

Al usar el SDK de @intlayer/api programáticamente, pasa backendURL explícitamente:

import { createIntlayerCMS } from "@intlayer/api";import { dictionaryEndpoint } from "@intlayer/api/dictionary";const cms = createIntlayerCMS({  editor: {    clientId: process.env.INTLAYER_CLIENT_ID,    clientSecret: process.env.INTLAYER_CLIENT_SECRET,    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100  },});const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();

Actualización

Volver a ejecutar el instalador en un despliegue existente realiza una actualización continua:

curl -fsSL https://intlayer.org/install.sh | sh

Esto descarga las últimas imágenes y reinicia los contenedores con docker compose pull && docker compose up -d. Los volúmenes existentes (mongo-data, redis-data, minio-data) se conservan, sin pérdida de datos.

Para actualizar manualmente desde el directorio ./intlayer/:

docker compose pulldocker compose up -d

Copia de seguridad y restauración

Todos los datos persistentes residen en tres volúmenes de Docker con nombre.

Copia de seguridad

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/mongo-data.tar.gz /datadocker run --rm \  -v intlayer_redis-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/redis-data.tar.gz /datadocker run --rm \  -v intlayer_minio-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/minio-data.tar.gz /data

Restauración

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar xzf /backup/mongo-data.tar.gz -C /# Repetir para redis-data y minio-data

Uso de un proxy inverso (Nginx / Caddy)

Para despliegues de producción, coloca un proxy inverso delante de los contenedores de la aplicación y del backend en lugar de exponerlos directamente.

Ejemplo de Nginx

server {    listen 80;    server_name cms.example.com;    location / {        proxy_pass http://localhost:3000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;    }}server {    listen 80;    server_name api.example.com;    location / {        proxy_pass http://localhost:3100;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;    }}

Actualiza las siguientes variables .env para que coincidan con tus dominios públicos:

BACKEND_URL=https://api.example.comAPP_URL=https://cms.example.comDOMAIN=example.comVITE_BACKEND_URL=https://api.example.comVITE_DOMAIN=example.com

Las variables VITE_* se integran en la imagen del dashboard en el momento de la construcción. Si las cambias después de que se construya la imagen, necesitas reconstruir la imagen de la app (docker compose build app) o usar la inyección de configuración en tiempo de ejecución.

Solución de problemas

Reinicios del backend en bucle al inicio

MongoDB y Redis deben estar saludables antes de que el backend se inicie. El archivo compose utiliza depends_on con condition: service_healthy. Si ves reinicios repetidos del backend, verifica que los healthchecks de mongo y redis pasen:

docker compose psdocker compose logs mongodocker compose logs redis

El dashboard no puede conectar con la API

Verifica que VITE_BACKEND_URL coincida con la URL donde el backend es accesible desde el navegador (no desde la red de Docker). Si cambiaste el puerto del backend o añadiste un proxy inverso, reconstruye la imagen del dashboard:

docker compose build appdocker compose up -d app

El correo electrónico no se envía

Por defecto, todos los correos electrónicos salientes son capturados por Mailpit. Abre http://localhost:8025 para ver los mensajes enviados. Para enviar correos electrónicos reales, establece MAIL_PROVIDER=resend y RESEND_API_KEY=<tu-clave> en .env, luego reinicia el backend:

docker compose restart backend

Falta el bucket de MinIO

Si el servicio de un solo uso minio-init no se ejecutó (o se ejecutó antes de que MinIO estuviera listo), crea el bucket manualmente:

docker compose run --rm minio-init

Enlaces útiles

• Documentación del CMS de Intlayer
• Referencia de configuración
• SDK del CMS — @intlayer/api