El problema: sus contactos están dispersos, y se filtran
Pregúntese dónde viven realmente sus datos de contacto. Su teléfono se sincroniza con iCloud o con Google. Su proveedor de correo conoce cada nombre de su bandeja. Su suscripción de CRM registra cada nota en una base situada en una jurisdicción que usted no elige. Y ninguna de esas herramientas responde a la pregunta más humana: ¿cuándo habló por última vez con esa persona, y de qué?
Monica CRM se diseñó para responderla. No es una herramienta comercial: ni pipeline, ni scoring, ni previsión de ingresos. Es un gestor de relaciones personales — un diario privado de las personas que importan, ejecutado en un servidor que usted posee.
Lo que Monica CRM hace, y lo que no hace
Monica organiza sus relaciones como lo haría alguien atento. Cada contacto dispone de una ficha que reúne:
- Un historial completo de las interacciones — cada nota, llamada, correo y cita que usted haya registrado, en orden cronológico.
- Recordatorios — cumpleaños, fechas señaladas, vencimientos personalizados, invitaciones recurrentes a retomar el contacto.
- El contexto personal — naturaleza de la relación (amigo, colega, mentor), profesión, empresa, cuentas sociales, campos libres que usted define.
- Eventos vitales — compromisos, nacimientos, cambios de empleo, eventos de salud; los hitos que dan profundidad a una relación.
- Ideas de regalos — una lista por contacto, y el registro de lo que realmente entregó.
Lo que Monica no hace: no rastrea negocios ni ingresos, no puntúa prospectos y no ofrece agenda compartida de equipo. Para un CRM empresarial, Twenty — también en el catálogo ServOrbit — es más adecuado. Monica se ocupa de la capa humana.
Monica CRM frente a las alternativas de código abierto
Desplace la tabla
| Monica CRM | HumHub Contacts | Twenty CRM | Duet | |
|---|---|---|---|---|
| Datos gestionados | Relaciones personales y profesionales: notas, recordatorios, eventos vitales, ideas de regalos | Red social interna: perfiles, grupos, espacio de trabajo colaborativo | CRM comercial: contactos, oportunidades, pipelines de ventas, objetos personalizados | Libreta de direcciones minimalista: tarjetas, etiquetas, notas — sin funciones de equipo |
| Licencia | AGPL-3.0 | AGPL-3.0 | AGPL-3.0 | MIT |
| Requisitos del servidor | 2 vCPU / 4 GB RAM — PHP, MariaDB, Redis | 4 vCPU / 8 GB RAM — PHP, MariaDB, Elasticsearch recomendado | 4 vCPU / 8 GB RAM — Node.js, PostgreSQL, Redis | 1 vCPU / 1 GB RAM — SQLite, binario Go único |
| Caso de uso principal | Seguimiento de red personal, recordatorios humanos, almacenamiento de datos de contacto conforme al RGPD | Intranet y red social empresarial, compartición de conocimiento | Gestión de la relación con clientes, automatización de ventas, API GraphQL para integraciones | Libreta de direcciones ligera, solo para uso individual |
Arquitectura: PHP/Laravel, MariaDB, Redis — tres contenedores, un VPS
La receta del catálogo ServOrbit despliega Monica en forma de tres contenedores Docker:
1. monicahq/monicahq:apache — la aplicación PHP/Laravel y su servidor Apache integrado, expuesta en el puerto 8080 del anfitrión.
2. mariadb:11 — la base relacional que almacena contactos, interacciones y recordatorios.
3. redis:7-alpine — la caché en memoria para las sesiones y las tareas en cola.
MariaDB es la única base de datos oficialmente compatible con Monica v4. La aplicación ejecuta sus migraciones automáticamente al primer arranque — sin paso separado, y la primera cuenta creada se convierte en administradora.
Huella de memoria en reposo: menos de 600 MB, lo que deja margen al sistema operativo y a Docker en el VPS Start (4 GB).
Desplegar Monica CRM en ServOrbit: paso a paso
Contrate un VPS con Ubuntu 24.04
El VPS Start (2 vCPU, 4 GB) basta. El proceso PHP de Monica consume menos de 256 MB; MariaDB añade de 150 a 300 MB. Sus 4 GB dejan margen incluso para una agenda voluminosa (más de 10 000 contactos) o un equipo pequeño. Elija Ubuntu 24.04 LTS — es el sistema operativo de destino del playbook de despliegue.
Despliegue desde el catálogo ServOrbit
Abra su área de cliente ServOrbit, vaya a Marketplace → ERP y Gestión Empresarial → Monica CRM y haga clic en Desplegar. El playbook genera automáticamente un
docker-compose.ymlcon las variables de entorno esenciales:MONICA_APP_KEY=base64:<clave-generada> DB_HOST=db DB_DATABASE=monica DB_USERNAME=monica DB_PASSWORD=<contraseña-generada> CACHE_DRIVER=redis SESSION_DRIVER=redis QUEUE_CONNECTION=redis REDIS_HOST=redisDescarga las tres imágenes, arranca la pila y espera el healthcheck. La interfaz está lista en menos de un minuto.
Cree su cuenta de administrador de inmediato
Abra
http://<ip-de-su-vps>:8080en el navegador y regístrese. La primera cuenta creada recibe automáticamente los derechos de administración. Hágalo en cuanto la interfaz esté disponible — el registro permanece abierto hasta que un administrador lo restrinja en Ajustes → Administración.Importe sus contactos existentes
Vaya a Ajustes → Importar y suba un archivo vCard (.vcf) exportado desde su teléfono, Google Contacts, Contactos de Apple u Outlook. Monica deduplica por dirección de correo y asigna los campos automáticamente. También se admite importación CSV con mapeo de columnas. Para Google Contacts, elija el formato vCard 3.0 al exportar.
Configure SMTP para recibir recordatorios por correo
Sin SMTP, los recordatorios solo aparecen en el panel. Para recibirlos en su bandeja, añada estas variables al archivo de entorno de su instancia:
MAIL_MAILER=smtp MAIL_HOST=smtp.su-relay.com MAIL_PORT=587 [email protected] MAIL_PASSWORD=su-contraseña MAIL_ENCRYPTION=tls [email protected] MAIL_FROM_NAME="Monica CRM"Relés compatibles: AWS SES, Mailgun, Brevo, Postmark. Reinicie el contenedor tras la actualización (
docker compose restart app).Establezca sus primeros recordatorios
Abra una ficha de contacto, haga clic en Añadir recordatorio y elija una fecha — única o recurrente (semanal, mensual, anual). Escriba una nota breve: «llamar para ponerse al día», «enviar tarjeta de cumpleaños». Monica muestra cada día los recordatorios pendientes en el panel y, si SMTP está configurado, también los envía a su bandeja.
Programe las copias de seguridad de MariaDB
La base de datos MariaDB es el único estado persistente de Monica. Dos enfoques:
Mediante Backrest (recomendado): el catálogo ServOrbit incluye Backrest — una interfaz web para restic — capaz de respaldar el volumen Docker de MariaDB hacia Backblaze B2, Wasabi o S3 según una programación, con deduplicación y cifrado.
Volcado manual: ejecute desde el anfitrión:
docker exec monica-db mysqldump -u monica -p<contraseña> monica > monica-$(date +%F).sqlGuarde también el archivo
.envy el volumenmonica_storage(avatares y adjuntos importados).
A quién le conviene Monica en un VPS
- Profesionales independientes y consultores — registra cada intercambio con el cliente y recupera, seis meses después, lo que se habló — sin pagar una suscripción de CRM.
- Fundadores y personas muy conectadas — inversores, asesores, socios y candidatos: toda la órbita de relaciones de la que vive una startup.
- Profesiones sujetas al RGPD (derecho, salud, finanzas) — no puede depositar información de sus clientes en un proveedor extranjero.
- Cualquiera que cuide de los suyos — los recordatorios de cumpleaños, el seguimiento de los acontecimientos vitales y las listas de regalos marcan la diferencia entre quien recuerda y quien olvida.
Confidencialidad y propiedad de los datos
Monica se publica bajo licencia AGPL-3.0. La versión autoalojada no incorpora telemetría, ni llamadas al editor, ni servicio de analítica. Su agenda, su historial de interacciones y sus notas personales permanecen en la instancia MariaDB que se ejecuta en su VPS.
Las copias de seguridad periódicas son responsabilidad del operador. El catálogo ServOrbit ofrece Backrest — una interfaz web para restic — capaz de respaldar el volumen MariaDB de Monica hacia Backblaze B2, Wasabi o S3, según una programación, con deduplicación y cifrado.
Para activar el envío de correos, establezca MAIL_MAILER=smtp en el entorno y apunte Monica hacia un relay transaccional (AWS SES, Mailgun, Brevo). Monica enviará entonces los recordatorios y los enlaces de restablecimiento de contraseña. Sin SMTP, ambas funciones siguen disponibles desde el panel — simplemente no llegarán a su bandeja.
Solución de problemas: los errores más frecuentes
Error 1: la migración de base de datos falla al primer arranque
Mensaje en los logs (docker compose logs app):
Illuminate\Database\QueryException: SQLSTATE[HY000] [2002] Connection refusedCausa: el contenedor app arrancó antes de que MariaDB estuviese lista para aceptar conexiones. Solución: añada una condición depends_on con service_healthy en su docker-compose.yml, o espere 20-30 segundos y reinicie solo el contenedor de la aplicación: docker compose restart app. Monica volverá a ejecutar las migraciones automáticamente.
Error 2: los recordatorios por correo no se envían
Mensaje en el panel de Monica (Ajustes → Registros) o en los logs del worker:
Swift_TransportException: Connection could not be established with host smtp.example.com [Connection refused #111]Causa: MAIL_MAILER no definido o relay SMTP inaccesible desde el contenedor. Compruebe que el cortafuegos del VPS permite el puerto 587 de salida (ufw allow out 587) y que MAIL_HOST, MAIL_PORT, MAIL_USERNAME y MAIL_PASSWORD están presentes en el entorno. Tras corregir, reinicie el worker: docker compose restart worker.
Error 3: la sesión expira en bucle tras la instalación
Síntoma: Monica redirige a la página de login en cada acción, incluso tras un inicio de sesión exitoso.
Causa: APP_KEY ausente o inválido — la clave AES-256 que cifra las cookies de sesión. Debe tener la forma base64:<cadena-de-44-caracteres>. Si está vacío o generado incorrectamente, las sesiones no pueden descifrarse.
Solución: genere una clave válida desde dentro del contenedor de la aplicación y actualice el entorno:
docker compose exec app php artisan key:generate --showCopie el valor devuelto en APP_KEY de su .env, luego reinicie la pila completa: docker compose down && docker compose up -d.
Conectarse por primera vez
Conectarse por primera vez
Abra la URL y cree su cuenta mediante el formulario de registro: esa primera cuenta se convierte en la administradora de la instancia. Hágalo de inmediato — el registro permanece abierto hasta que un administrador lo restrinja.
Actualizar Monica a una nueva versión
Monica sigue un ciclo de versiones regular en la imagen Docker monicahq/monicahq. Para actualizar: descargue la nueva imagen, detenga la pila, reinicie — las migraciones se ejecutan automáticamente al arrancar.
docker compose pull
docker compose down
docker compose up -d
docker compose logs -f appConfirme que Database is up to date o Migrated successfully aparece en los logs antes de usar la aplicación. En caso de duda, realice un volcado de MariaDB antes de actualizar.
