Huly: sustituir Linear, Notion y Slack en su VPS

Por qué centralizar incidencias, documentación y chat en una sola herramienta

Lo que Huly consolida en su infraestructura

• Incidencias y sprints — cree tickets y organícelos en sprints y hojas de ruta con tableros Kanban integrados, sin salir de la aplicación.
• Wiki y documentación — redacte páginas estructuradas directamente en Huly; los documentos quedan versionados y vinculados a los proyectos correspondientes.
• Chat en tiempo real — mensajería por canales y por hilos, con videollamadas integradas, para sustituir Slack sin ninguna suscripción adicional.
• Sincronización bidireccional con GitHub — las incidencias de Huly se replican en GitHub y a la inversa; las pull requests de GitHub aparecen automáticamente en las incidencias vinculadas.
• Time tracking — registre el tiempo dedicado a cada incidencia directamente desde la interfaz, sin extensiones de terceros.

Requisitos exactos: lo que Huly consume realmente

Desplegar Huly en un VPS en cinco pasos

1. 01

   Clonar el repositorio oficial

   Recupere la configuración desde el repositorio público: git clone https://github.com/hcengineering/huly-selfhost.git && cd huly-selfhost. El repositorio incluye compose.yml y el script setup.sh, que genera automáticamente la configuración nginx y el archivo .env.

2. 02

   Ejecutar el script de configuración

   Ejecute ./setup.sh e introduzca la dirección de su subdominio (p. ej. huly.ejemplo.com). El script genera huly_v7.conf con la versión (HULY_VERSION), los secretos JWT, las credenciales de MinIO y las rutas de volúmenes. Active la configuración nginx con sudo ln -s $(pwd)/nginx.conf /etc/nginx/sites-enabled/huly.conf && sudo nginx -s reload.

3. 03

   Levantar los servicios con Docker Compose

   Arranque toda la pila con docker compose up -d. En el primer arranque, Elasticsearch y CockroachDB inicializan sus datos; calcule entre dos y tres minutos antes de que la interfaz esté accesible. Compruebe el estado de los contenedores con docker compose ps — todos deben mostrar el estado running.

4. 04

   Configurar el reverse proxy HTTPS

   El script setup.sh ya genera la configuración nginx con TLS. Si usa Caddy o Traefik, apunte el reverse proxy al puerto interno del servicio front (8083 por defecto). Asegúrese de que los WebSockets se transmiten correctamente mediante las cabeceras Upgrade y Connection — sin ellas, la mensajería en tiempo real y las videollamadas no funcionarán.

5. 05

   Crear el primer espacio de trabajo e invitar al equipo

   Abra su subdominio en un navegador, cree una cuenta de administrador y genere su primer espacio de trabajo. Desde los ajustes del espacio, envíe invitaciones por correo electrónico a sus colaboradores. No se contabiliza ningún puesto de pago: solo paga el almacenamiento y el ancho de banda consumidos en su VPS.

Configuración post-instalación: backup, alertas y actualizaciones

Configurar backup, monitorización y actualizaciones

1. 06

   Automatizar las copias de seguridad

   El repositorio incluye dos scripts listos para usar: backup-create.sh y backup-restore.sh. Ejecute ./backup-create.sh desde la carpeta huly-selfhost para archivar todos los volúmenes (CockroachDB, Elasticsearch, MinIO). Programe el script mediante cron — por ejemplo 0 3 * * * /opt/huly-selfhost/backup-create.sh >> /var/log/huly-backup.log 2>&1 para un backup diario a las 3 h. Almacene los archivos fuera del VPS (S3, bucket Hetzner o disco remoto). Para migraciones mayores (p. ej. v0.6.x → v0.7.x), consulte siempre MIGRATION.md antes de restaurar.

2. 07

   Monitorizar la salud de los contenedores

   Configure una alerta sencilla ejecutando docker compose ps en un cron cada cinco minutos, o despliegue una herramienta ligera como Uptime Kuma (disponible como aplicación self-hosted en el mismo VPS). Monitorice prioritariamente los servicios account, transactor y elasticsearch — son los responsables de los fallos más visibles. Los registros de cada servicio están disponibles con docker compose logs -f <nombre-del-servicio>.

3. 08

   Actualizar a una nueva versión

   Antes de cada actualización, lea MIGRATION.md para la versión objetivo. Si la sección dice "No changes required", el procedimiento es sencillo: edite HULY_VERSION en huly_v7.conf con el nuevo tag (p. ej. v0.7.426), luego ejecute git pull && docker compose pull && docker compose up -d. Para una actualización mayor (0.6.x → 0.7.x), siga los pasos de migración documentados, especialmente en torno a la sección v0.7.204 — una migración directa bloquea los datos de MongoDB de forma difícil de revertir.

Resolución de errores: cuatro problemas frecuentes y sus soluciones

Errores frecuentes y remedios

• El registro falla en silencio al crear la cuenta. Causa probable: el servicio account no es accesible o está mal configurado. Revise sus registros con docker compose logs -f account — un error de callback URL o un problema de conexión a CockroachDB aparecerá claramente. Asegúrese de que HULY_HOST en su configuración coincide exactamente con el subdominio publicado.
• Elasticsearch no arranca (código de salida 137 u OOMKilled). Causa: memoria insuficiente. Elasticsearch requiere al menos 4 GB de RAM para él solo al arrancar. Si su VPS está al límite, añada ES_JAVA_OPTS=-Xms1g -Xmx1g en la sección environment del servicio elasticsearch en compose.yml para limitar su heap Java a 1 GB — a costa del rendimiento de búsqueda.
• MinIO inaccesible — los adjuntos no se cargan. Causa: problemas de permisos en los volúmenes o un fallo de resolución DNS interna entre contenedores. Compruebe que el servicio minio está en estado running con docker compose ps. Si los archivos subidos desaparecen tras un reinicio, verifique que la ruta de volumen en huly_v7.conf es una ruta absoluta válida en el host y que los permisos son correctos (chown -R 1000:1000 /var/huly/files).
• Los WebSockets no funcionan — mensajería y videollamadas bloqueadas. Causa: el reverse proxy no reenvía las cabeceras Upgrade: websocket y Connection: Upgrade. En nginx, añada explícitamente proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; dentro del bloque location. Con Caddy, la directiva reverse_proxy gestiona los WebSockets automáticamente en versiones recientes.

¿Para qué equipos tiene sentido Huly?

Huly frente a Linear + Notion + Slack: lo que gana y lo que asume

Desplace la tabla