Relaticle | CRM | AI | Docker

Relaticle en Docker: CRM open-source con agentes AI nativos

CRM auto-hospedable con soporte nativo de agentes AI, 30 herramientas MCP, API REST, aislamiento multi-equipo y 22 tipos de campo personalizados. Construido sobre Laravel 12, Filament 5 y PHP 8.4.

¿Qué es Relaticle?

Relaticle es un CRM open-source auto-hospedable con soporte nativo de agentes AI. Integra directamente con modelos como Claude, GPT o modelos open-source a través de su servidor MCP con 30 herramientas para operaciones completas de CRM. Ideal para equipos de desarrollo, startups y PYMES.

En Docker: Relaticle se despliega en 5 contenedores (app, horizon, scheduler, postgres, redis) con un único archivo docker-compose. Arquitectura lista para producción c on migraciones automáticas, colas y tareas programadas.

Ventaja principal: Un CRM self-hosted que no depende de servicios SAP/CRM tradicionales. Tus datos permanecen en tu servidor, con API REST completa y esquema de datos p ersonalizable, permitiendo que agentes AI actúen sobre ellos en tiempo real sin compartir la data fuera de tu infraestructura.

Características principales

Agentes AI nativos

Soporte directo con Claude, GPT y modelos open-source.

30 Herramientas MCP

Operaciones completas de CRM expuestas a agentes AI.

API REST completa

CRUD completo y schema discovery para integraciones.

Modelo de datos customizable

22 tipos de campo incluyendo relaciones entre entidades.

Multi-equipo con aislamiento

5 capas de autorización y workscopes aislados por equipo.

Stack moderno

Laravel 12, Filament 5, PHP 8.4, 1100+ tests automatizados.

Datos propios, Privacy-First

AGPL-3.0, tus datos permanecen en tu server.

Panel sysadmin

Administración de instancia global y todos los equipos.

Filament UI elegante

Interfaz de administración moderna y fácil de usar.

Integraciones OAuth

Notificaciones y colas

Horizon para trabajos en segundo plano.

SSL y Reverse Proxy

Fácil integración con Nginx, Caddy o Traefik.

Requisitos del sistema

Docker 20.10+ y Docker Compose v2.0+
2 GB de RAM (mínimo), 4 GB recomendados
1 core de CPU (2 cores recomendados para producción)
10 GB de disco (20 GB recomendados para producción)
Acceso a puertos: mapeado por defecto al 80 (APP_PORT)

Nota importante: La app interna escucha en el puerto 8080 dentro del contenedor, mapeado a 80 en el host. Si ya tienes otro servicio en el puerto 80, define otro APP_PO RT en tu `.env`.

Instalación rápida con Docker Compose

Paso 1: Descargar el compose fichero

curl -o compose.yml https://raw.githubusercontent.com/Relaticle/relaticle/main/compose.yml

Paso 2: Generar la clave de aplicación

echo "APP_KEY=base64:$(openssl rand -base64 32)"

Paso 3: Crear el archivo `.env`

APP_KEY=base64:your-generated-key-here DB_PASSWORD=your-secure-database-password APP_URL=https://crm.tudominio.com

Paso 4: Iniciar los contenedores

docker compose up -d

Paso 5: Crear usuario administrador

docker compose exec app php artisan make:filament-user

Accede ahora a APP_URL/app con tus credenciales.

Tip: El admin creado automáticamente con make:filament-user ya está verificado. No necesitas configurar SMTP para activar la cuenta.

Configuración avanzada

Arquitectura de contenedores

Relaticle usa 5 contenedores:

| Contenedor | Imagen | Función | |---------------|-----------------------------------|------------------------------------------| | app | ghcr.io/relaticle/relaticle:latest| Servidor web (nginx + PHP-FPM) | | horizon | ghcr.io/relaticle/relaticle:latest| Procesa trabajos en background (Horizon) | | scheduler | ghcr.io/relaticle/relaticle:latest| Tareas programadas (schedule:work) | | postgres | postgres:17-alpine | Base de datos PostgreSQL | | redis | redis:7-alpine | Cache, sesiones y colas |

Volumes persistentes

| Volumen | Función | |---------------|-------------------------------------------| | postgres | Archivos de la BD. ¡Back-up! | | redis | Datos de persistencia de Redis | | storage | Archivos subidos y storage de aplicación |

Variables de entorno obligatorias

APP_KEY=base64:$(openssl rand -base64 32) DB_PASSWORD=tu-password-segura

Despliegue con Caddy

crm.example.com { reverse_proxy localhost }

Caddy maneja SSL via Let's Encrypt automáticamente.

Despliegue con Traefik

labels: - traefik.enable=true - traefik.http.routers.relaticle.rule=Host(`crm.example.com`) - traefik.http.routers.relaticle.entrypoints=websecure - traefik.http.routers.relaticle.tls.certresolver=letsencrypt

Primeros pasos

1. Acceder al panel de CRM

Abre https://crm.tudominio.com/app
Inicia sesión con el admin creado en el paso 5
Completa el onboarding o desactívalo en las configuraciones

2. Crear un pipeline de ventas o soporte

Navega a CRM > Opportunities
Haz clic en Add New Opportunity
Asocia contactos, empresas y defines etapas del pipeline

3. Configurar agente AI con MCP

Visita /docs/mcp para ver las 30 herramientas MCP
Conecta tu agente (Claude, GPT, etc.) apuntando a la URL MCP de tu instancia
Empieza a interactuar con el CRM desde conversaciones en lenguaje natural

4. Gestionar multi-equipo

En Settings > Teams crea nuevos equipos
Asocia usuarios y roles por equipo
Configura campos personalizados y permisos

Feature flags configurables

Puedes ajustar estas variables para controlar comportamiento de la instancia:

RELATICLE_FEATURE_ONBOARD_SEED=true # Demostración con datos de ejemplo al registrar equipo< /span> RELATICLE_FEATURE_SOCIAL_AUTH=true # Habilitar login Google/GitHub RELATICLE_FEATURE_DOCUMENTATION=true # Ruta de documentación `/docs`

Gestión y mantenimiento

Actualizar a la última versión

docker compose pull docker compose up -d

Las migraciones se ejecutan automáticamente en el arranque.

Backup de base de datos

docker compose exec postgres pg_dump -U relaticle relaticle > backup-$(date +%Y%m%d).sql

Restaurar base de datos

docker compose exec -T postgres psql -U relaticle relaticle < backup-YYYYMMDD.sql

Ver logs

docker compose logs -f app

Reiniciar servicios

docker compose restart

Estado de Horizon (colas)

docker compose exec app php artisan horizon:status

Recomendación: Siempre realiza backup de los volúmenes postgres y storage antes de actualizaciones. Revisa las release notes en GitHub para de tectar cambios breaking antes de actualizar.

Solución de problemas comunes

Error "APP_KEY is required"

Genera y añade tu clave en el archivo .env, luego reinicia:

echo "APP_KEY=base64:$(openssl rand -base64 32)" >> .env hopde compose up -d

Contenedor reiniciando en loop

Revise los logs:

docker compose logs app --tail 50

Causas comunes: falta de memoria (<2GB), variables de entorno incorrectas, o PostgreSQL aún levantándose.

Errores 500 después del despliegue

docker compose exec app php artisan optimize:clear

Asegúrate que APP_URL concuerda con tu dominio real.

Horizon no procesando trabajos

docker compose restart horizon hopde exec app php artisan horizon:status

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Cómo instalar Relaticle en Docker - CRM con Agentes AI en Docker