Guía de Inicio Rápido

Esta traducción es anterior a los nuevos controles de activación y despliegue seguro. Use la guía en inglés hasta que esta página se actualice.

¿Buscas una forma más fácil? Usa nuestro Instalador de Escritorio para un despliegue con un clic y configuración automática. ¡Sin línea de comandos!

Requisitos Previos

Antes de comenzar, asegúrese de tener instalado lo siguiente en su sistema:

Docker Engine (20.10.0 o superior)
Docker Compose (v2.0.0 o superior)
OpenSSL (para generar certificados SSL)

Instalación de Docker

Para macOS:

Descargue e instale Docker Desktop desde Docker Hub
Siga el asistente de instalación
Verifique la instalación:

docker --version
docker compose --version

Para Linux (Ubuntu/Debian):

# Actualizar el índice de paquetes
sudo apt-get update

# Instalar requisitos previos
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# Añadir la clave GPG oficial de Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# Configurar el repositorio estable
echo \
  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Instalar Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Añadir su usuario al grupo docker
sudo usermod -aG docker $USER

Para Windows:

Descargue e instale Docker Desktop desde Docker Hub
Habilite WSL 2 siguiendo la documentación de Docker
Siga el asistente de instalación
Verifique la instalación en PowerShell:

docker --version
docker compose --version

Paso 1: Crear el Directorio del Proyecto

Cree un nuevo directorio para su despliegue de CaseBender y acceda a él:

mkdir casebender-deployment
cd casebender-deployment

Paso 2: Configurar las Variables de Entorno

Cree un archivo .env con el siguiente contenido:

# Autenticación
AUTH_SECRET="B7OawnWf6+LwB/9yXbxbk4ppZ1khydqj4qc9k9g3nnE="
AUTH_SALT="B7OawnW"
AUTH_TRUST_HOST=true
NEXTAUTH_URL=https://local.casebender.com
NEXTAPP_URL=https://local.casebender.com

# Licencia (opcional)
# CaseBender genera y conserva automáticamente una clave secreta de licencia en el
# primer arranque (almacenada en el volumen "casebender_secret") y la reutiliza
# tras reinicios y actualizaciones — no se requiere ninguna acción. Defina
# LICENSE_SECRET_KEY solo si desea gestionar la clave usted mismo: respaldarla,
# rotarla o compartirla entre réplicas. Genere una con: openssl rand -hex 32
# LICENSE_SECRET_KEY=

# Configuración de Liveblocks (colaboración en tiempo real)
LIVEBLOCKS_SECRET_KEY=sk_dev_HaIczPV4gPit5_gx7YRsNXLGJNzBE5wQ8z8I1H8ft3ZPZHVrfH2ryJJ586ezHYla

# Configuración de la Base de Datos (el host es el servicio interno "db")
POSTGRES_PASSWORD=88AlwaysTimeToWin88
POSTGRES_PRISMA_URL="postgresql://superadmin:88AlwaysTimeToWin88@db:5432/casebender?schema=public"
POSTGRES_URL="postgresql://superadmin:88AlwaysTimeToWin88@db:5432/casebender?schema=public"
POSTGRES_URL_NON_POOLING="postgresql://superadmin:88AlwaysTimeToWin88@db:5432/casebender?schema=public"

# Configuración de Redis
REDIS_URL="redis://redis:6379"
# Alternativa con host/puerto — la leen todos los servicios (también cubre
# imágenes antiguas que no interpretan REDIS_URL para la cola de trabajos).
REDIS_HOST=redis
REDIS_PORT=6379

CaseBender se ejecuta como varios contenedores: la aplicación web (app), una pasarela de API REST (api), una pasarela de ingesta de alertas (ingestion, que recibe los webhooks de integración como el de Microsoft Defender), un worker en segundo plano y los procesadores workflow y MISP. Nginx se sitúa al frente y enruta el tráfico al servicio correcto. Todos están incluidos en el archivo Compose a continuación.

Paso 3: Generar Certificados SSL

Para desarrollo local, genere certificados SSL autofirmados:

# Generar certificado y clave SSL
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout local-casebender.key \
  -out local-casebender.crt \
  -subj "/CN=local.casebender.com/O=CaseBender/C=US"

# Verificar el certificado
openssl x509 -in local-casebender.crt -text -noout

Paso 4: Configurar Nginx

Cree nginx.conf con el siguiente contenido:

events {
    worker_connections 1024;
}

http {
    # ─── Upstreams ─────────────────────────────────────────────
    upstream web_app {
        server app:3000;
    }

    upstream api_service {
        server api:3005;
    }

    upstream ingestion_service {
        server ingestion:3003;
    }

    # ─── Limitación de Tasa ────────────────────────────────────
    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=100r/s;
    limit_req_zone $binary_remote_addr zone=ingest_limit:10m rate=1000r/s;

    # ─── Redirección HTTP -> HTTPS ─────────────────────────────
    server {
        listen 80;
        server_name local.casebender.com;
        return 301 https://$server_name$request_uri;
    }

    # ─── Servidor HTTPS Principal ──────────────────────────────
    server {
        listen 443 ssl;
        http2 on;
        server_name local.casebender.com;

        ssl_certificate /etc/nginx/certs/local-casebender.crt;
        ssl_certificate_key /etc/nginx/certs/local-casebender.key;

        ssl_protocols TLSv1.2 TLSv1.3;
        client_max_body_size 100M;

        # ─── Cabeceras de Seguridad ───────────────────────────
        add_header X-Frame-Options "SAMEORIGIN" always;
        add_header X-Content-Type-Options "nosniff" always;
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

        # ─── API de Ingesta (webhooks de integración) ─────────
        location /api/v1/ingest/ {
            limit_req zone=ingest_limit burst=500 nodelay;
            proxy_pass http://ingestion_service;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }

        # Ruta de ingesta heredada
        location /api/ingest/ {
            limit_req zone=ingest_limit burst=500 nodelay;
            proxy_pass http://ingestion_service;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }

        # ─── Pasarela de API REST ─────────────────────────────
        location /api/v1/ {
            limit_req zone=api_limit burst=50 nodelay;
            proxy_pass http://api_service;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }

        location /api/openapi.json {
            proxy_pass http://api_service;
            proxy_set_header Host $host;
        }

        # ─── Comprobación de Salud ────────────────────────────
        location /health {
            access_log off;
            return 200 "healthy";
            add_header Content-Type text/plain;
        }

        # ─── Aplicación Web (catch-all) ───────────────────────
        location / {
            proxy_pass http://web_app;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            proxy_set_header X-Forwarded-Host $host;
            proxy_set_header X-Forwarded-Port $server_port;

            # Soporte de WebSocket
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";

            proxy_connect_timeout 60s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
        }
    }
}

Paso 5: Crear la Configuración de Docker Compose

Cree docker-compose.yml con el siguiente contenido:

services:
  # ─── Servicios Principales ───────────────────────────────────
  app:
    image: casebender/casebender:latest
    platform: linux/amd64
    ports:
      - "3000:3000"
    environment:
      - AUTH_SECRET=${AUTH_SECRET}
      - AUTH_SALT=${AUTH_SALT}
      - AUTH_TRUST_HOST=true
      - NEXTAUTH_URL=${NEXTAUTH_URL:-https://local.casebender.com}
      - NEXTAPP_URL=${NEXTAPP_URL:-https://local.casebender.com}
      - LICENSE_SECRET_KEY=${LICENSE_SECRET_KEY}
      - LIVEBLOCKS_SECRET_KEY=${LIVEBLOCKS_SECRET_KEY}
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    volumes:
      # Conserva el secreto y el blob de licencia autogenerados entre
      # actualizaciones para que `docker compose pull` no regenere la licencia.
      - casebender_secret:/app/apps/web/app/secret
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "node -e \"require('http').get('http://localhost:3000/api/health', (r) => process.exit(r.statusCode === 200 ? 0 : 1)).on('error', () => process.exit(1))\""]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 60s

  api:
    image: casebender/api:latest
    platform: linux/amd64
    ports:
      - "3005:3005"
    environment:
      - PORT=3005
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
      - AUTH_SECRET=${AUTH_SECRET}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  ingestion:
    image: casebender/ingestion:latest
    platform: linux/amd64
    ports:
      - "3003:3003"
    environment:
      - PORT=3003
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  # ─── Servicios de Procesamiento ──────────────────────────────
  worker:
    image: casebender/worker:latest
    platform: linux/amd64
    ports:
      - "3002:3002"
    environment:
      - PORT=3002
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  workflow-processor:
    image: casebender/workflow-processor:latest
    platform: linux/amd64
    ports:
      - "3001:3001"
    environment:
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
      app:
        condition: service_healthy
    restart: unless-stopped

  misp-processor:
    image: casebender/misp-processor:latest
    platform: linux/amd64
    ports:
      - "3004:3004"
    environment:
      - PORT=3004
      - POSTGRES_PRISMA_URL=${POSTGRES_PRISMA_URL}
      - POSTGRES_URL=${POSTGRES_URL}
      - POSTGRES_URL_NON_POOLING=${POSTGRES_URL_NON_POOLING}
      - REDIS_URL=${REDIS_URL:-redis://redis:6379}
      - REDIS_HOST=${REDIS_HOST:-redis}
      - REDIS_PORT=${REDIS_PORT:-6379}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
      app:
        condition: service_healthy
    restart: unless-stopped

  # ─── Infraestructura ─────────────────────────────────────────
  db:
    image: postgres:17
    environment:
      POSTGRES_USER: superadmin
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-88AlwaysTimeToWin88}
      POSTGRES_DB: casebender
    ports:
      - "5433:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U superadmin -d casebender"]
      interval: 5s
      timeout: 5s
      retries: 10
      start_period: 30s
    restart: unless-stopped

  redis:
    image: redis:7.2-alpine
    command: redis-server --protected-mode no
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 5
    restart: unless-stopped

  minio:
    image: quay.io/minio/minio
    mem_limit: 512m
    command: ["minio", "server", "/data", "--console-address", ":9090"]
    environment:
      - MINIO_ROOT_USER=minioadmin
      - MINIO_ROOT_PASSWORD=minioadmin
    ports:
      - "9090:9090"
      - "9000:9000"
    volumes:
      - "miniodata:/data"
    restart: unless-stopped

  # ─── Proxy Inverso ───────────────────────────────────────────
  nginx:
    image: nginx:alpine
    ports:
      - "443:443"
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
      - ./local-casebender.crt:/etc/nginx/certs/local-casebender.crt:ro
      - ./local-casebender.key:/etc/nginx/certs/local-casebender.key:ro
    depends_on:
      app:
        condition: service_healthy
    restart: unless-stopped

volumes:
  miniodata:
  pgdata:
  redis_data:
  casebender_secret:

¿Necesita búsqueda empresarial (OpenSearch)? El Instalador de Escritorio puede añadir los servicios search-sync, opensearch y opensearch-dashboards por usted. Para la mayoría de las evaluaciones locales, la búsqueda basada en PostgreSQL anterior es todo lo que necesita.

Paso 6: Configurar el DNS Local

Añada la siguiente entrada a su archivo hosts:

Para macOS y Linux:

sudo echo "127.0.0.1 local.casebender.com" >> /etc/hosts

Para Windows:

Añada la siguiente línea a C:\Windows\System32\drivers\etc\hosts:

127.0.0.1 local.casebender.com

Paso 7: Iniciar la Aplicación

Descargue las imágenes necesarias:

docker compose pull

Inicie todos los servicios:

docker compose up -d

Supervise los registros:

docker compose logs -f

Acceda a la aplicación en https://local.casebender.com

Credenciales de Acceso Predeterminadas

Después de desplegar CaseBender, puede iniciar sesión con las siguientes credenciales predeterminadas:

Usuario: admin@casebender.app
Contraseña: secret1234

Por razones de seguridad, recomendamos encarecidamente cambiar estas credenciales predeterminadas inmediatamente después de su primer inicio de sesión.

Ejecutar detrás de un proxy corporativo

Si su host solo puede acceder a internet a través de un proxy HTTP corporativo (redes “solo con proxy”), las llamadas salientes de CaseBender —activación de licencia e integraciones como Microsoft Defender y Splunk— deben enrutarse a través de él. Añada las variables de proxy a su .env:

HTTP_PROXY=http://proxy.example.com:8080
HTTPS_PROXY=http://proxy.example.com:8080
# Los servicios internos de Docker (y cualquier destino on-prem) DEBEN omitir el proxy:
NO_PROXY=127.0.0.1,localhost,db,redis,minio,api,ingestion,worker,workflow-processor,misp-processor,search-sync,opensearch

Luego páselas a cada servicio de CaseBender añadiendo estas líneas al bloque environment: de cada servicio en docker-compose.yml:

      - HTTP_PROXY=${HTTP_PROXY:-}
      - HTTPS_PROXY=${HTTPS_PROXY:-}
      - NO_PROXY=${NO_PROXY:-}

NO_PROXY debe incluir los nombres de los servicios internos de Docker anteriores. De lo contrario, el tráfico entre contenedores (p. ej., la app web llamando al servicio de ingesta) se envía al proxy corporativo y falla — rompiendo la aplicación aunque no tenga nada que ver con internet.

¿Qué destinos pasan por el proxy? Los endpoints públicos deben pasar por el proxy y NO deben estar en NO_PROXY — p. ej., Microsoft Defender (login.microsoftonline.com, graph.microsoft.com). Los destinos on-prem deben listarse en NO_PROXY para alcanzarse directamente — p. ej., un Splunk HEC interno. Si usa Splunk Cloud, déjelo fuera para que se enrute por el proxy.

Verifique la conectividad desde dentro de un contenedor (usa node, sin necesidad de curl):

docker compose exec app node -e "fetch('https://login.microsoftonline.com/',{signal:AbortSignal.timeout(5000)}).then(r=>console.log('OK',r.status)).catch(e=>console.log('FAIL',e.message))"

Cuando hay un proxy configurado, cada servicio registra [proxy] Outbound fetch routed through corporate proxy (...) al iniciar.

Solución de Problemas

Problemas Comunes

Advertencias de Certificado:
- El navegador mostrará una advertencia de seguridad porque usamos un certificado autofirmado
- Haga clic en “Avanzado” y continúe hacia el sitio web
- Para fines de desarrollo, esto es esperado y seguro
Conflictos de Puertos:
- Asegúrese de que los puertos 80, 443, 3000, 3001, 3002, 3003, 3004, 3005, 5433, 6379, 9000 y 9090 no estén en uso
- Si es necesario, modifique las asignaciones de puertos en docker-compose.yml
Conexión a la Base de Datos:
- Revise los registros de PostgreSQL: docker compose logs db
- Verifique las credenciales de la base de datos en .env
- Asegúrese de que la base de datos esté en ejecución: docker compose ps db
Dependencias de Servicios:
- Si los servicios no arrancan, revise sus dependencias:
docker compose ps docker compose logs [nombre_del_servicio]

Revisar Registros

Vea los registros de servicios específicos:

# Todos los servicios
docker compose logs

# Un servicio específico
docker compose logs [nombre_del_servicio]

# Seguir los registros
docker compose logs -f [nombre_del_servicio]

Gestión de Servicios

# Reiniciar un servicio específico
docker compose restart [nombre_del_servicio]

# Detener todos los servicios
docker compose down

# Eliminar volúmenes (borrará todos los datos)
docker compose down -v

Siguientes Pasos

Ahora que tiene CaseBender funcionando localmente, es posible que desee:

Despliegue en Producción

Despliegue CaseBender en su entorno de producción

Configuración

Conozca las opciones de configuración avanzada

Primeros Pasos

Implementación

Gestión de Alertas

Gestión de Casos

Gestión de Tareas

Analítica

Auditorías

Configuración

Guía de Inicio Rápido

Requisitos Previos

Instalación de Docker

Para macOS:

Para Linux (Ubuntu/Debian):

Para Windows:

Paso 1: Crear el Directorio del Proyecto

Paso 2: Configurar las Variables de Entorno

Paso 3: Generar Certificados SSL

Paso 4: Configurar Nginx

Paso 5: Crear la Configuración de Docker Compose

Paso 6: Configurar el DNS Local

Para macOS y Linux:

Para Windows:

Paso 7: Iniciar la Aplicación

Credenciales de Acceso Predeterminadas

Ejecutar detrás de un proxy corporativo

Solución de Problemas

Problemas Comunes

Revisar Registros

Gestión de Servicios

Siguientes Pasos

Despliegue en Producción

Configuración

​Requisitos Previos

​Instalación de Docker

​Para macOS:

​Para Linux (Ubuntu/Debian):

​Para Windows:

​Paso 1: Crear el Directorio del Proyecto

​Paso 2: Configurar las Variables de Entorno

​Paso 3: Generar Certificados SSL

​Paso 4: Configurar Nginx

​Paso 5: Crear la Configuración de Docker Compose

​Paso 6: Configurar el DNS Local

​Para macOS y Linux:

​Para Windows:

​Paso 7: Iniciar la Aplicación

​Credenciales de Acceso Predeterminadas

​Ejecutar detrás de un proxy corporativo

​Solución de Problemas

​Problemas Comunes

​Revisar Registros

​Gestión de Servicios

​Siguientes Pasos

Despliegue en Producción

Configuración

Requisitos Previos

Instalación de Docker

Para macOS:

Para Linux (Ubuntu/Debian):

Para Windows:

Paso 1: Crear el Directorio del Proyecto

Paso 2: Configurar las Variables de Entorno

Paso 3: Generar Certificados SSL

Paso 4: Configurar Nginx

Paso 5: Crear la Configuración de Docker Compose

Paso 6: Configurar el DNS Local

Para macOS y Linux:

Para Windows:

Paso 7: Iniciar la Aplicación

Credenciales de Acceso Predeterminadas

Ejecutar detrás de un proxy corporativo

Solución de Problemas

Problemas Comunes

Revisar Registros

Gestión de Servicios

Siguientes Pasos