Ever Gauzy es una suite de software open source diseñada para la gestión completa de las operaciones empresariales. Ofrece una amplia gama de funcionalidades que cubren áreas críticas como recursos humanos (HR), gestión de relaciones con clientes (CRM), finanzas y gestión de proyectos. Su naturaleza open source lo convierte en una solución flexible y personalizable, ideal para organizaciones de diversos tamaños, desde autónomos hasta pequeñas y medianas empresas, que buscan consolidar sus herramientas operativas en una única plataforma.
La adopción de un sistema de gestión integrado como Ever Gauzy puede generar mejoras significativas en la eficiencia operativa, reduciendo la fragmentación de datos y la complejidad de gestionar múltiples programas. Esto se traduce en una mayor visibilidad de los procesos empresariales, una mejor colaboración entre departamentos y una reducción de los costos de TI relacionados con licencias e integraciones. Ever Gauzy responde a la creciente necesidad de soluciones completas pero adaptables, que permitan a las empresas mantener el control sobre sus datos y operaciones sin depender de proveedores propietarios. Cuando migré 300 VMs a Proxmox para una organización sanitaria pública, la unificación de herramientas fue clave para optimizar recursos; Ever Gauzy ofrece una promesa similar para el software de gestión.
Tested on: Ubuntu 24.04 LTS · Node.js 18.x · PostgreSQL 14 · Docker 24.0 · Septiembre 2026
Requisitos Previos / Entorno de Prueba
Para instalar y probar Ever Gauzy, es necesario disponer de un entorno Linux con Docker y Docker Compose instalados. La solución se basa en una arquitectura de microservicios y utiliza PostgreSQL como base de datos. Asegúrate de que los puertos necesarios (típicamente 80, 443, 3000, 3001) estén libres o sean configurables a través de un reverse proxy. Para la parte de desarrollo o personalización, se requiere conocimiento de Node.js, Angular (frontend) y NestJS (backend).
# Verifica instalación Docker
docker --version
# Verifica instalación Docker Compose
docker compose version
# Si no está instalado, sigue la guía oficial de Docker:
# curl -fsSL https://get.docker.com -o get-docker.sh
# sudo sh get-docker.sh
# sudo usermod -aG docker $USER
# newgrp docker
1. Instalación y Configuración Inicial
La instalación de Ever Gauzy puede realizarse mediante Docker Compose, lo que simplifica el despliegue de todos los microservicios necesarios. Es recomendable clonar el repositorio de GitHub para tener acceso a los archivos de configuración y los scripts de inicio.
Clonación del repositorio
Comienza clonando el repositorio oficial de Ever Gauzy desde su cuenta de GitHub. Esto te proporcionará todos los archivos fuente y los archivos Docker Compose necesarios.
git clone https://github.com/ever-co/ever-gauzy.git
cd ever-gauzy
Configuración de las variables de entorno
Ever Gauzy utiliza variables de entorno para la configuración de la base de datos, las credenciales y otros parámetros operativos. Es fundamental crear un archivo .env basado en la plantilla proporcionada y personalizarlo. Lee también: Gestión de Variables de Entorno en Producción
cp .env.example .env
# Edita el archivo .env con tus configuraciones (ej. contraseña de la base de datos, secretos JWT)
nano .env
Asegúrate de establecer contraseñas robustas para la base de datos y claves JWT seguras. Estos son pasos críticos para la seguridad de tu instalación.
Inicio de los servicios
Una vez configurado el archivo .env, puedes iniciar todos los servicios utilizando Docker Compose. El proceso podría tardar algunos minutos en el primer arranque, ya que Docker deberá descargar las imágenes de los contenedores.
docker compose up -d
Este comando iniciará los contenedores en modo detached, permitiéndote seguir usando el terminal. Puedes verificar el estado de los servicios con docker compose ps.
2. Acceso a la Interfaz de Usuario
Después del inicio de los servicios, la interfaz de usuario de Ever Gauzy será accesible a través del navegador. Por defecto, está disponible en el puerto 3000 o 4200, dependiendo de la configuración específica y de cómo se exponga el frontend. La documentación oficial Ever Gauzy Documentation proporciona detalles precisos sobre los puertos y las rutas.
Accede a la URL en tu navegador (ej. la IP de tu servidor). En el primer acceso, se te pedirá que crees una cuenta de administrador para tu organización. Esta cuenta tendrá el control completo sobre todos los módulos y las configuraciones del sistema. Lee también: Hardening de Credenciales Iniciales: Prácticas Esenciales
Errores Comunes y Resolución de Problemas
- Puertos ya en uso: Si Docker Compose no logra iniciar los servicios, podría deberse a puertos ya ocupados. Revisa el archivo
docker-compose.ymly el archivo.envpara ver qué puertos se están utilizando y asegúrate de que estén libres o modifica las configuraciones. - Problemas con la base de datos: Si el contenedor PostgreSQL no se inicia correctamente o los servicios dependientes no pueden conectarse, verifica las variables de entorno relacionadas con la base de datos en el archivo
.env(ej.DATABASE_URL,POSTGRES_PASSWORD). Comprueba también los logs del contenedor PostgreSQL condocker logs. - Problemas de rendimiento: En entornos con múltiples servicios activos, Ever Gauzy puede requerir recursos significativos. Asegúrate de que tu servidor tenga suficiente RAM y CPU. Un monitoreo de los recursos mediante
htopodocker statspuede ayudar a identificar cuellos de botella. - Errores en la interfaz de usuario: Si el frontend no carga correctamente, limpia la caché del navegador o intenta acceder en modo incógnito. Revisa los logs del contenedor frontend para detectar posibles errores de JavaScript o de conexión al backend.
FAQ — Preguntas Frecuentes
¿Ever Gauzy es adecuado para empresas de cualquier tamaño?
Sí, su arquitectura modular y la naturaleza open source lo hacen escalable. Los autónomos pueden usar solo los módulos de facturación y CRM, mientras que las PYMES pueden aprovechar toda la suite para HR, finanzas y gestión de proyectos. La personalización es un punto fuerte.
¿Cuáles son los requisitos hardware mínimos para una instalación en producción?
Para un entorno de producción con pocos usuarios, se recomiendan al menos 4GB de RAM y 2 vCPU. Para entornos más grandes con cientos de usuarios y muchos datos, es aconsejable asignar 8GB+ de RAM y 4+ vCPU, además de un disco SSD de alto rendimiento para la base de datos. Lee también: Dimensionamiento de Servidores para Aplicaciones Web Enterprise
¿Puedo integrar Ever Gauzy con otros sistemas empresariales existentes?
Absolutamente sí. Al ser open source y estar basado en una arquitectura API-driven, Ever Gauzy está diseñado para ser integrable. Puedes desarrollar conectores personalizados o utilizar herramientas de integración para intercambiar datos con otros programas como sistemas ERP o plataformas de comunicación.
¿Cuál es el nivel de seguridad ofrecido por Ever Gauzy?
Como software open source, Ever Gauzy se beneficia de la revisión de la comunidad, lo que contribuye a identificar y resolver rápidamente las vulnerabilidades. Es fundamental seguir las mejores prácticas de seguridad, como el uso de contraseñas robustas, la configuración de un firewall y la implementación de un reverse proxy con SSL/TLS.
Conclusiones con Puntos Clave Operativos
Ever Gauzy representa una solución potente y flexible para las empresas que desean consolidar su gestión operativa. Su suite integrada de módulos HR, CRM, finanzas y gestión de proyectos, unida a la naturaleza open source, ofrece un control y una personalización difícilmente igualables por soluciones propietarias. La implementación requiere un conocimiento básico de Docker y configuración de entorno, pero los beneficios en términos de eficiencia y reducción de costos son notables. Evalúa Ever Gauzy si tu organización busca un gestor completo, escalable y con una fuerte impronta open source.
Fuentes
Actualizado: Septiembre 2026