Bienvenido a la Guía de Instalación de Evo CRM Community - Documentação do Evolution Foundation

Evo CRM Community es la edición gratuita y open-source de Evo CRM. Instalas todo en tu propio servidor — tus datos se quedan contigo, sin cuotas mensuales y sin límites de uso. La plataforma está formada por 5 servicios que trabajan juntos:

Servicio	Qué hace	Puerto
`evo-auth-service-community`	Gestiona el login y los permisos de acceso	3001
`evo-ai-crm-community`	Gestiona conversaciones, contactos y bandejas	3000
`evo-ai-frontend-community`	La interfaz visual que usas en el navegador	5173
`evo-ai-processor-community`	Ejecuta los agentes de IA	8000
`evo-ai-core-service-community`	Gestiona agentes, carpetas y claves de API	5555

Esta edición no tiene panel de administración global, planes de facturación ni soporte para múltiples cuentas. Es simple por diseño.

Antes de Empezar

Necesitarás tres herramientas instaladas en tu máquina:

Docker y Docker Compose — crean y gestionan los contenedores donde corre cada servicio. Haz clic aquí para instalar
Git — descarga el código del proyecto. Haz clic aquí para instalar
make — simplifica la ejecución de comandos largos. Generalmente ya viene instalado en Linux y macOS. Haz clic aquí para instalar

Paso a Paso

Paso 1 — Descarga el proyecto

Abre la terminal y ejecuta:

git clone --recurse-submodules [email protected]:evolution-foundation/evo-crm-community.git
cd evo-crm-community

Este comando descarga el repositorio principal y todos los servicios que forman la plataforma de una sola vez.

Si ya clonaste el repositorio sin el flag --recurse-submodules, ejecuta este comando para descargar los servicios que faltan:

git submodule update --init --recursive

Paso 2 — Actualiza los servicios a la última versión

git submodule update --remote --merge

Esto garantiza que cada servicio esté en la versión más reciente disponible. Hazlo siempre que quieras actualizar la plataforma.

Paso 3 — Elige dónde correrá la base de datos

Antes de configurar el .env, decide dónde estará alojada la base de datos. Hay tres opciones:

Opción A — Docker (predeterminado, recomendado para empezar)

No necesitas hacer nada. Docker Compose ya levanta un PostgreSQL automáticamente. Ve directamente al Paso 4.

Opción B — PostgreSQL instalado localmente

¿Prefieres instalar PostgreSQL directamente en tu máquina? Usa la versión 16 o superior con la extensión pgVector habilitada.

Sistema	Cómo instalar
Linux	Guía oficial para Linux
macOS	Postgres.app — la forma más sencilla
Windows	Instalador oficial

Después de instalar, habilita pgVector en la base de datos:

CREATE EXTENSION IF NOT EXISTS vector;

Opción C — Base de datos en la nube

También puedes usar un servicio administrado. Consulta las opciones compatibles:

Proveedor	pgVector nativo	Documentación oficial
Supabase	✅	supabase.com/docs/…/pgvector
Neon	✅	neon.tech/docs/…/pgvector
AWS RDS	✅	docs.aws.amazon.com/…/PostgreSQL.ExtensionsAndModules
Google Cloud SQL	✅	cloud.google.com/sql/docs/…/extensions
Azure PostgreSQL	✅	learn.microsoft.com/…/how-to-use-pgvector
Railway	✅	docs.railway.app/databases/postgresql

Si elegiste la Opción B o C, después de crear la base de datos, ajusta estas 5 variables en el .env (Paso 4):

DB_HOST=localhost       # Dirección del servidor de base de datos
DB_PORT=5432            # Puerto predeterminado de PostgreSQL
DB_NAME=evo_crm         # Nombre de la base de datos que creaste
DB_USER=tu_usuario      # Usuario de la base de datos
DB_PASSWORD=tu_clave    # Contraseña de la base de datos

Evo CRM Community no es compatible con MySQL, MariaDB ni SQLite. Usa siempre PostgreSQL 16 o superior con la extensión pgVector habilitada.

Paso 4 — Configura las variables de entorno

cp .env.example .env

Este comando crea el archivo .env a partir de una plantilla lista. Ábrelo con cualquier editor de texto y ajusta las configuraciones a tu entorno. Si te quedaste con la Opción A (Docker), los valores predeterminados ya funcionan. No necesitas cambiar nada por ahora.

Paso 5 — Ejecuta el setup

make setup

Este único comando se encarga de todo, en el orden correcto:

Construye las imágenes Docker de todos los servicios
Levanta la base de datos y espera a que esté lista
Crea las tablas y carga los datos iniciales
Inicia todos los servicios

En la primera ejecución, el proceso puede tardar de 15 a 20 minutos. Docker necesita descargar y compilar todas las imágenes. La próxima vez será mucho más rápido.

Paso 6 — Accede a la plataforma

Cuando el setup termine, abre el navegador y ve a:

http://localhost:5173

La plataforma está lista para usar.

Servicios disponibles

Interfaz	Dirección
Frontend	`http://localhost:5173`
CRM API	`http://localhost:3000`
Auth API	`http://localhost:3001`
Processor API	`http://localhost:8000`
Core API	`http://localhost:5555`
Mailhog (correo)	`http://localhost:8025`

Comandos del día a día

Después del setup, usa estos comandos para gestionar la plataforma:

Comando	Qué hace
`make start`	Inicia todos los servicios
`make stop`	Detiene todos los servicios
`make restart`	Reinicia todos los servicios
`make status`	Muestra qué contenedores están corriendo
`make logs`	Muestra los logs de todos los servicios en tiempo real
`make logs SERVICE=nombre`	Filtra los logs de un servicio específico (ej: `SERVICE=evo-crm`)
`make build`	Reconstruye todas las imágenes desde cero (sin caché)
`make seed`	Repobla los datos iniciales de la base de datos
`make shell-auth`	Abre una terminal dentro del contenedor del Auth
`make shell-crm`	Abre una terminal dentro del contenedor del CRM
`make shell-core`	Abre una terminal dentro del contenedor del Core
`make shell-processor`	Abre una terminal dentro del contenedor del Processor
`make clean`	Detiene todo y elimina todos los datos permanentemente

make clean no tiene vuelta atrás. Elimina la base de datos, el caché y todos los archivos generados. Úsalo solo si quieres empezar desde cero.

Próximos pasos

Primeros Pasos

Accede por primera vez y configura tu cuenta

Configurar Canales

Conecta WhatsApp, correo, Telegram y otros canales

Configurar Agentes IA

Crea y configura tus agentes de atención con IA

Variables de Entorno

Referencia completa de todas las variables disponibles

¿Necesitas ayuda?

GitHub: evolution-foundation/evo-crm-community
Comunidad: evolutionfoundation.com.br/community
Issues: ¿Encontraste un problema? Abre un issue en el repositorio del servicio correspondiente

​Antes de Empezar

​Paso a Paso

​Paso 1 — Descarga el proyecto

​Paso 2 — Actualiza los servicios a la última versión

​Paso 3 — Elige dónde correrá la base de datos

​Opción A — Docker (predeterminado, recomendado para empezar)

​Opción B — PostgreSQL instalado localmente

​Opción C — Base de datos en la nube

​Paso 4 — Configura las variables de entorno

​Paso 5 — Ejecuta el setup

​Paso 6 — Accede a la plataforma

​Servicios disponibles

​Comandos del día a día

​Próximos pasos

Primeros Pasos

Configurar Canales

Configurar Agentes IA

Variables de Entorno

​¿Necesitas ayuda?

Antes de Empezar

Paso a Paso

Paso 1 — Descarga el proyecto

Paso 2 — Actualiza los servicios a la última versión

Paso 3 — Elige dónde correrá la base de datos

Opción A — Docker (predeterminado, recomendado para empezar)

Opción B — PostgreSQL instalado localmente

Opción C — Base de datos en la nube

Paso 4 — Configura las variables de entorno

Paso 5 — Ejecuta el setup

Paso 6 — Accede a la plataforma

Servicios disponibles

Comandos del día a día

Próximos pasos

¿Necesitas ayuda?