Cómo instalar Hermes Agent en Coolify (paso a paso en tu VPS)

hermes agent en coolify

Hay algo que me sigue sorprendiendo de todo lo que está ocurriendo con la inteligencia artificial: dedicamos muchísimo tiempo a probar modelos, comparar respuestas y descubrir nuevas herramientas, pero a veces nos olvidamos de lo más interesante, que es conseguir que esas herramientas trabajen realmente para nosotros.

Y no me refiero a abrir un chat y hacerle preguntas. Hablo de tener un agente de inteligencia artificial funcionando en nuestro propio servidor, capaz de ejecutar tareas, utilizar herramientas, trabajar con archivos y conservar información entre distintas interacciones.

banner hosting

Precisamente por eso me parece tan interesante Hermes Agent, un proyecto de Nous Research que podemos ejecutar en nuestro propio VPS.

Ahora bien, una cosa es probar un agente durante unos minutos y otra muy diferente es mantenerlo funcionando de forma estable y segura. Tenemos que pensar en los contenedores, las actualizaciones, las credenciales, la persistencia de datos y los permisos que vamos a concederle.

Aquí es donde entra Coolify.

En esta guía vamos a ver cómo instalar Hermes Agent en Coolify paso a paso, utilizando Docker Compose y un servidor VPS. Empezaremos con una configuración sencilla, comprobaremos que funciona y después veremos cómo añadir integraciones, proteger los accesos y mantener el servicio.

Mi objetivo no es complicar la instalación con todas las funciones disponibles desde el primer día. Prefiero preparar una base sólida que podamos ampliar cuando realmente la necesitemos.

Resumen del Artículo ocultar

¿Qué es Hermes Agent y para qué sirve?

Hermes Agent es un agente de inteligencia artificial desarrollado por Nous Research que permite interactuar con modelos de lenguaje y utilizar herramientas para realizar tareas.

Su principal atractivo es que no tenemos que limitarnos a escribir preguntas y esperar respuestas. Podemos configurarlo para trabajar con archivos, ejecutar determinadas operaciones, acceder a herramientas y conservar información útil para futuras interacciones.

Además, podemos instalarlo en nuestra propia infraestructura, sin depender necesariamente de un servicio que aloje toda la aplicación por nosotros.

Esto no significa que los modelos de IA se ejecuten automáticamente en nuestro servidor. Hermes Agent puede conectarse a proveedores externos, por lo que debemos diferenciar entre alojar el agente y alojar el modelo que utiliza.

Qué puede hacer Hermes Agent como agente de inteligencia artificial

Imaginemos que administramos un servidor y queremos utilizar la inteligencia artificial para ayudarnos con determinadas tareas.

En lugar de copiar constantemente información desde una terminal hasta un chatbot, podemos preparar un agente que disponga de herramientas autorizadas para consultar archivos, interpretar registros o trabajar con determinados procesos.

También podemos utilizarlo como punto de partida para automatizaciones, integraciones con aplicaciones o asistentes accesibles mediante plataformas de mensajería.

Estas capacidades dependen de las herramientas que instalemos, los permisos que concedamos y los modelos que configuremos.

Y aquí es donde encuentro una de las principales ventajas de Hermes: podemos empezar con funciones sencillas y ampliar las posibilidades conforme descubramos necesidades concretas.

Diferencias entre Hermes Agent y un chatbot convencional

Cuando utilizamos un chatbot tradicional, normalmente escribimos un mensaje, recibimos una respuesta y decidimos qué hacer con ella.

Un agente como Hermes puede participar de forma más activa en un flujo de trabajo.

Por ejemplo, si queremos analizar determinados archivos, un chatbot puede explicarnos los comandos necesarios. Un agente correctamente configurado podría utilizar una herramienta para consultar esos archivos directamente.

La diferencia parece pequeña, pero cambia bastante la manera de trabajar.

Eso sí, también implica una responsabilidad adicional: si permitimos que el agente ejecute comandos o modifique archivos, debemos controlar cuidadosamente el alcance de esas capacidades.

¿Por qué instalar Hermes Agent en Coolify?

Personalmente, creo que uno de los problemas de muchas herramientas de inteligencia artificial es que su instalación termina convirtiéndose en un pequeño proyecto de administración de sistemas.

Empezamos instalando dependencias, configuramos Docker, revisamos variables de entorno y buscamos cómo mantener los procesos funcionando. Cuando conseguimos que todo arranque, todavía tenemos que preocuparnos por las actualizaciones.

Coolify simplifica buena parte de la administración de las aplicaciones que desplegamos en nuestro servidor.

No sustituye los conocimientos básicos sobre Linux y Docker, pero permite organizar y gestionar los servicios desde una interfaz web.

Ventajas de utilizar Coolify frente a una instalación manual

Podríamos instalar Hermes Agent directamente en un VPS mediante el procedimiento nativo de Linux.

De hecho, esa alternativa puede tener sentido cuando queremos ejecutar el agente como un servicio del sistema operativo.

Pero si ya utilizamos Coolify para administrar aplicaciones, me parece más práctico mantener Hermes dentro del mismo entorno.

Con Coolify podemos:

  • Crear y administrar aplicaciones y servicios.
  • Desplegar contenedores mediante Docker Compose.
  • Consultar registros y revisar despliegues.
  • Reiniciar servicios cuando sea necesario.
  • Configurar almacenamiento persistente.
  • Administrar variables de entorno.
  • Integrar otras aplicaciones dentro de nuestra infraestructura.

La ventaja no está únicamente en instalar Hermes Agent. Está en facilitar su mantenimiento y permitirnos desplegar otros componentes relacionados sin administrar cada uno como un proyecto independiente.

Por qué utilizar un VPS con Coolify preinstalado

Para empezar, utilizaría uno de los servidores VPS con Coolify preinstalado de HostingTG.

La razón es bastante sencilla: si el servidor ya dispone de Coolify preparado, podemos centrarnos directamente en la configuración de Hermes Agent.

Además, considero importante disponer de acceso administrativo al VPS.

Un agente de inteligencia artificial puede necesitar almacenamiento adicional, herramientas específicas o modificaciones que no siempre encajan en un alojamiento compartido.

Tener acceso root al servidor nos da flexibilidad para administrar la infraestructura, aunque eso no significa que debamos ejecutar el agente con privilegios ilimitados.

Una cosa es tener control sobre nuestro servidor y otra permitir que el agente tenga acceso a todo lo que contiene.

Requisitos para instalar Hermes Agent en un VPS

Antes de empezar a instalar Hermes Agent en Coolify, necesitamos comprobar que nuestro servidor dispone de una configuración adecuada.

No hace falta comenzar con una infraestructura especialmente compleja. Para las primeras pruebas, lo importante es tener un entorno compatible, almacenamiento suficiente y acceso al proveedor de inteligencia artificial que vayamos a utilizar.

Qué características debe tener el servidor VPS

Los recursos dependerán de las funciones que activemos.

Como orientación inicial, utilizaría esta tabla:

RecursoPunto de partida orientativo
Sistema operativoUbuntu o Debian compatibles con Docker y Coolify
Procesador2 vCPU para comenzar
Memoria RAM4 GB para una configuración ligera
Almacenamiento20–40 GB libres como referencia inicial
ConectividadConexión estable a Internet
AdministraciónAcceso SSH y permisos para gestionar Docker

Estas cifras son recomendaciones para planificar un entorno, no requisitos mínimos oficiales ni resultados de pruebas de rendimiento.

Si nuestro VPS ya ejecuta varias aplicaciones, tendremos que sumar el consumo de Coolify, los contenedores existentes y las herramientas que utilice Hermes.

Para un entorno con más servicios o automatizaciones exigentes, personalmente valoraría un VPS con 8 GB de RAM o más.

Qué necesitamos antes de empezar: Coolify, Docker y acceso SSH

En esta guía vamos a dar por hecho que ya tenemos Coolify funcionando.

También necesitaremos:

  1. Un VPS al que podamos acceder mediante SSH.
  2. Docker instalado y operativo.
  3. Permisos suficientes para ejecutar comandos Docker.
  4. Acceso al panel de Coolify.
  5. Espacio disponible para almacenar los datos del agente.
  6. Una cuenta o endpoint compatible con el proveedor de IA que queramos utilizar.

Podemos comprobar que Docker funciona ejecutando:

docker --version

Y consultar los contenedores existentes mediante:

docker ps

Si ambos comandos funcionan, tenemos una primera confirmación de que podemos administrar Docker desde la terminal.

Conviene recordar que los comandos que veremos se ejecutan en el VPS donde se desplegará Hermes Agent, no necesariamente en el equipo desde el que abrimos el panel de Coolify.

Cómo elegir el proveedor de modelos de inteligencia artificial

Hermes Agent necesita un modelo de IA para procesar nuestras solicitudes.

Podemos utilizar proveedores compatibles o preparar una infraestructura de inferencia propia, dependiendo del modelo y del tipo de instalación.

Aquí hay una cuestión importante que prefiero aclarar antes de continuar: instalar Hermes Agent no significa disponer automáticamente de inteligencia artificial gratuita e ilimitada.

El software del agente y el servicio de inferencia son componentes distintos.

Si utilizamos una API comercial, debemos consultar sus precios y límites. Si ejecutamos modelos locales, tendremos que contar también con los recursos de cómputo necesarios.

Para una primera instalación en un VPS pequeño, personalmente empezaría utilizando un proveedor externo compatible. Así evitamos añadir el consumo de un modelo local al del propio agente.

Paso 1. Preparar el VPS y el almacenamiento persistente

Antes de desplegar el contenedor, vamos a preparar el directorio donde Hermes Agent conservará sus datos.

Para mí, este es uno de los pasos más importantes de toda la instalación.

No queremos que el agente pierda sus configuraciones, sesiones, memoria o credenciales cada vez que actualizamos su imagen Docker.

Acceder al servidor mediante SSH

Abrimos una terminal y nos conectamos al VPS:

ssh usuario@IP_DE_TU_VPS

Debemos sustituir usuario por nuestro usuario administrativo y IP_DE_TU_VPS por la dirección correspondiente.

Si nuestro proveedor utiliza otro puerto SSH, tendremos que indicarlo con el parámetro -p.

Una vez dentro, podemos comprobar que tenemos permisos suficientes para administrar Docker.

Es preferible utilizar autenticación mediante claves SSH y evitar trabajar permanentemente con una sesión root cuando no sea necesario.

Crear el directorio para guardar los datos de Hermes Agent

Vamos a crear una ubicación persistente dentro de /opt:

sudo mkdir -p /opt/hermes-agent/data

Este directorio almacenará la información que Hermes escriba en la ruta /opt/data dentro del contenedor.

La relación será:

VPS:
  /opt/hermes-agent/data
            |
            | Montaje Docker
            v
Contenedor Hermes:
  /opt/data

¿Por qué utilizamos esta ruta?

Porque la documentación oficial de la imagen Docker de Hermes Agent establece /opt/data como directorio persistente para los datos del usuario.

Podemos utilizar otra ruta en el servidor, siempre que mantengamos correctamente el destino dentro del contenedor.

Antes de continuar, conviene comprobar que estamos trabajando en el servidor adecuado y que disponemos de espacio suficiente.

df -h /opt

Por qué es importante conservar configuraciones, sesiones y memoria

Imaginemos que hemos configurado el modelo de IA, conectado un servicio de mensajería y preparado varias herramientas.

Después actualizamos el contenedor.

Si la información importante se encontraba exclusivamente dentro de su sistema de archivos temporal, podríamos perderla al recrearlo.

Utilizando un montaje persistente, los datos permanecen en el VPS aunque se sustituya el contenedor.

Esto es precisamente lo que busco cuando preparo una herramienta que quiero utilizar durante meses.

Eso sí, almacenamiento persistente no significa copia de seguridad.

Si perdemos el VPS, se daña el disco o borramos accidentalmente el directorio, también podemos perder los datos.

Por eso tendremos que incorporar una estrategia de copias de seguridad cuando la instalación empiece a utilizarse de forma habitual.

Paso 2. Configurar Hermes Agent antes del despliegue

Con el almacenamiento preparado, vamos a realizar la configuración inicial de Hermes Agent.

La imagen Docker oficial permite ejecutar un asistente interactivo para seleccionar el proveedor de modelos y preparar las credenciales necesarias.

Preparar la imagen Docker y el asistente de configuración

Primero descargamos la imagen:

docker pull nousresearch/hermes-agent:latest

Después ejecutamos el asistente:

docker run -it --rm \
  -v /opt/hermes-agent/data:/opt/data \
  nousresearch/hermes-agent:latest setup

Vamos a desglosar el comando:

ParámetroFunción
docker runEjecuta un contenedor
-itPermite interactuar con el asistente
--rmElimina el contenedor temporal al finalizar
-vMonta nuestro directorio persistente
nousresearch/hermes-agent:latestUtiliza la imagen oficial estable
setupInicia el asistente de configuración

Lo interesante es que este contenedor solo se utiliza para configurar Hermes. No será todavía nuestro servicio permanente de Coolify.

Cuando terminemos, los datos preparados por el asistente quedarán en el directorio persistente.

Configurar las credenciales del proveedor de IA

Durante el asistente tendremos que elegir la modalidad de conexión al modelo de inteligencia artificial.

Las opciones concretas pueden cambiar entre versiones.

Si utilizamos un proveedor con API key, tendremos que introducir las credenciales correspondientes siguiendo las indicaciones del instalador.

También podemos configurar otras opciones disponibles, como determinados canales de comunicación.

Mi recomendación es empezar únicamente con lo necesario.

No tiene demasiado sentido activar todas las integraciones desde el primer momento si todavía no sabemos si la configuración básica funciona.

Además, conviene tener presente que el asistente puede guardar información sensible dentro del directorio persistente.

Comprobar que la configuración se ha guardado correctamente

Cuando finalice el asistente, podemos revisar qué archivos existen en el directorio:

sudo ls -la /opt/hermes-agent/data

La configuración puede incluir archivos como .env y otros datos utilizados por Hermes.

No necesitamos mostrar públicamente su contenido.

De hecho, evitaría ejecutar comandos que impriman las claves API en una terminal compartida o copiar capturas de pantalla donde aparezcan credenciales.

Si queremos comprobar la existencia del archivo de entorno sin mostrarlo, podemos utilizar:

sudo test -f /opt/hermes-agent/data/.env \
  && echo "Archivo de entorno encontrado" \
  || echo "Revisar configuración"

También debemos comprobar los permisos del directorio.

La imagen oficial de Hermes utiliza un usuario sin privilegios para sus servicios. Si aparecen errores de acceso al almacenamiento, tendremos que revisar el propietario y los permisos en lugar de conceder acceso indiscriminado.

No recomiendo solucionar estos problemas utilizando chmod 777.

Paso 3. Instalar Hermes Agent en Coolify con Docker Compose

Ahora sí, vamos a desplegar Hermes Agent desde Coolify.

La ventaja de utilizar Docker Compose es que podemos describir el servicio en un archivo y mantener su configuración de forma relativamente sencilla.

Crear un proyecto y añadir un recurso Docker Compose

Entramos en nuestro panel de Coolify.

Después seleccionamos el proyecto donde queremos instalar Hermes Agent.

Si todavía no tenemos uno, podemos crear un proyecto específico para organizar nuestros servicios de inteligencia artificial.

Dentro del entorno correspondiente, añadimos un nuevo recurso de tipo Docker Compose Empty, o la opción equivalente en nuestra versión de Coolify.

Seleccionamos el servidor donde queremos realizar el despliegue.

Es importante escoger el mismo VPS en el que hemos creado /opt/hermes-agent/data.

Si Coolify administra varios servidores, cada uno dispone de su propio sistema de archivos y el montaje no aparecerá automáticamente en los demás.

Configurar el archivo Docker Compose de Hermes Agent

En el editor de Docker Compose vamos a introducir esta configuración básica:

services:
  hermes-agent:
    image: nousresearch/hermes-agent:latest
    restart: unless-stopped
    command: gateway run

    volumes:
      - /opt/hermes-agent/data:/opt/data

Esta es la configuración inicial que utilizaría para desplegar el gateway sin publicar sus puertos.

La hemos mantenido deliberadamente sencilla.

El archivo establece cuatro aspectos fundamentales:

  • Utiliza la imagen oficial de Hermes Agent.
  • Reinicia el contenedor automáticamente cuando corresponda.
  • Ejecuta el gateway.
  • Conserva los datos mediante el montaje persistente.

No hemos añadido ports, por lo que esta definición no publica directamente los puertos del servicio en el VPS.

Esto no significa que Hermes esté completamente aislado de la red ni que todas sus capacidades estén automáticamente protegidas. Las comunicaciones salientes, las redes Docker y los permisos de las herramientas también deben revisarse.

Esta configuración está orientada a ejecutar el gateway y los canales que hayamos configurado, no a ofrecer directamente un dashboard público.

Si queremos abrir una interfaz web o utilizar la API desde otros equipos, necesitaremos una configuración adicional.

Montar el volumen persistente y desplegar el contenedor

Guardamos el archivo Docker Compose.

Coolify permite validar la definición antes de desplegarla. Conviene utilizar esta opción para detectar posibles errores de sintaxis.

Después revisamos los volúmenes, las variables de entorno y la configuración generada por Coolify.

Si todo es correcto, iniciamos el despliegue.

Coolify descargará la imagen si es necesario y creará el servicio correspondiente.

Durante el primer arranque debemos prestar atención a los registros.

Si el contenedor falla, lo primero será comprobar el error concreto en lugar de modificar varias configuraciones a la vez.

Hay otro detalle que considero importante: aunque latest permite utilizar la versión estable publicada, para instalaciones de producción puede ser preferible fijar una versión concreta o un digest de imagen.

De esa manera, evitamos cambios inesperados al actualizar.

Paso 4. Comprobar que Hermes Agent funciona correctamente

Llegados a este punto, Hermes Agent debería haber iniciado su proceso de gateway.

Pero no daría por terminada la instalación simplemente porque Coolify muestre el contenedor como activo.

Personalmente, prefiero verificar que el servicio permanece funcionando, revisar sus registros y confirmar que los datos persisten después de un reinicio.

Verificar el estado del contenedor desde Coolify

En el panel de Coolify podemos consultar el estado del recurso.

También podemos hacerlo mediante SSH:

docker ps

Buscamos el contenedor correspondiente a Hermes Agent.

Si no aparece entre los contenedores en ejecución, podemos ampliar la consulta:

docker ps -a

Esta segunda opción también muestra los contenedores detenidos.

Es posible que Coolify haya asignado al contenedor un nombre diferente del utilizado en nuestro archivo Compose.

Por eso, antes de ejecutar comandos sobre él, debemos identificar su nombre real.

Consultar los registros y detectar errores de arranque

Desde Coolify podemos acceder a los registros del servicio.

También podemos utilizar:

docker logs --tail 100 NOMBRE_CONTENEDOR

Sustituimos NOMBRE_CONTENEDOR por el nombre obtenido mediante docker ps.

Si queremos consultar los mensajes mientras se generan:

docker logs -f NOMBRE_CONTENEDOR

En esta primera revisión buscaría especialmente errores relacionados con:

  • Archivos de configuración inexistentes.
  • Credenciales incorrectas.
  • Problemas de permisos.
  • Dificultades para conectarse con el proveedor de IA.
  • Servicios que se detienen o reinician inesperadamente.

Que el contenedor aparezca como activo confirma que Docker lo mantiene en ejecución, pero no garantiza que el modelo responda correctamente.

Para validar el funcionamiento real, también debemos realizar una interacción desde la CLI o desde un canal que hayamos configurado.

Comprobar la persistencia después de reiniciar el servicio

Esta es una prueba que considero imprescindible.

Primero comprobamos que los archivos de configuración están en el directorio del VPS:

sudo ls -la /opt/hermes-agent/data

Después reiniciamos el servicio desde Coolify.

Cuando vuelva a estar operativo, revisamos que los archivos continúan disponibles y que las funciones configuradas siguen funcionando.

También podemos comprobar que Docker utiliza el montaje esperado:

docker inspect NOMBRE_CONTENEDOR \
  --format '{{json .Mounts}}'

En el resultado debe aparecer la relación entre el directorio del VPS y /opt/data.

Esta comprobación no sustituye una prueba completa de recuperación, pero permite detectar errores básicos de montaje.

Para mí, es uno de esos detalles que separan una instalación de prueba de un servicio preparado para utilizarse habitualmente.

Paso 5. Configurar las integraciones y proteger Hermes Agent

Esta es probablemente la parte a la que prestaría más atención.

Hermes Agent puede trabajar con herramientas y servicios externos, pero no creo que debamos concederle acceso indiscriminado a nuestro servidor.

Cuantas más capacidades activemos, más importante será revisar qué puede hacer cada herramienta.

Conectar Hermes Agent con herramientas y servicios externos

Una vez que el gateway funciona correctamente, podemos empezar a incorporar integraciones.

Por ejemplo, podríamos conectarlo con una plataforma de mensajería compatible para comunicarnos con él sin acceder constantemente al VPS.

También podemos preparar herramientas para trabajar con archivos o interactuar con aplicaciones propias.

Si utilizamos Coolify para administrar otros servicios, tendremos la posibilidad de desplegar aplicaciones adicionales y organizar sus comunicaciones mediante redes Docker.

En ese caso, debemos distinguir entre los servicios que necesitan comunicarse entre sí y los que deben permanecer aislados.

No hace falta que todo nuestro entorno esté conectado desde el principio.

Personalmente, empezaría por una integración sencilla, comprobaría su funcionamiento y solo después añadiría nuevas capacidades.

Limitar permisos y proteger las claves API

Aquí aplicaría una regla básica: conceder únicamente los permisos necesarios.

Si Hermes necesita consultar un directorio, no deberíamos darle automáticamente permisos de escritura sobre todo el sistema.

Tampoco montaría el sistema de archivos completo del VPS dentro del contenedor.

Evitaría especialmente montar el socket de Docker del servidor en Hermes, salvo que exista una necesidad muy justificada y medidas específicas de aislamiento. Ese acceso puede permitir un control muy amplio del host.

Las credenciales también necesitan protección.

Debemos evitar incluir claves API directamente en el Docker Compose si podemos gestionarlas mediante mecanismos más adecuados.

Coolify dispone de gestión de variables de entorno, y Hermes también puede utilizar los archivos de configuración persistentes que genera su asistente.

En cualquier caso, debemos proteger esos valores, revisar quién puede acceder a ellos y no publicarlos en repositorios.

La seguridad de un agente de IA no depende únicamente del software que instalamos, sino también de lo que le permitimos hacer.

Configurar acceso remoto seguro cuando sea necesario

Hermes Agent dispone de un gateway que puede ofrecer una API y de un dashboard web que podemos activar.

Son componentes diferentes.

La documentación oficial identifica el puerto 8642 para el gateway y el 9119 para el dashboard.

Sin embargo, no recomiendo publicar esos puertos directamente en Internet como parte de una instalación inicial.

Las versiones actuales de Hermes Agent incorporan controles de autenticación para el dashboard cuando escucha en una interfaz no local.

Si queremos activar su interfaz web, debemos configurar un proveedor de autenticación compatible y verificar correctamente el acceso.

Para determinados entornos privados puede utilizarse autenticación básica junto con una red de confianza o una VPN. Para despliegues públicos es preferible utilizar una configuración de autenticación apropiada, como OAuth u OIDC, además de HTTPS y restricciones de acceso.

Coolify puede formar parte de esta arquitectura mediante su gestión de servicios y proxy, pero no debemos confundir disponer de un dominio con tener un acceso seguro.

Una alternativa que me parece razonable para empezar es mantener el dashboard privado y acceder mediante un mecanismo como una VPN o un túnel SSH, según la configuración del servicio.

Lo importante es no activar una interfaz administrativa pública sin haber comprobado antes cómo se autentican los usuarios.

Cuántos recursos necesita Hermes Agent en un VPS

No creo que exista una respuesta única para todos los casos.

El consumo dependerá de cómo utilicemos Hermes Agent, del proveedor del modelo, de las herramientas instaladas y del resto de aplicaciones que se ejecuten en el servidor.

No es lo mismo mantener un gateway conectado a una API externa que ejecutar navegadores automatizados, procesos pesados y modelos locales.

¿Es suficiente un VPS con 4 GB de RAM?

Para una configuración inicial relativamente ligera, 4 GB de RAM pueden ser un punto de partida razonable.

Pero esto no significa que sean suficientes en todos los escenarios.

Tenemos que considerar el consumo de Coolify, Docker, el sistema operativo y cualquier otro servicio que ya esté funcionando.

Si el servidor dispone de poca memoria libre, incluso una aplicación moderada puede provocar problemas cuando coinciden varias tareas.

Mi recomendación es comprobar el consumo real antes de activar demasiadas herramientas.

Podemos consultar los recursos utilizados por los contenedores mediante:

docker stats

Y revisar la memoria disponible del servidor con:

free -h

Estas herramientas nos ofrecen una referencia mucho más útil que elegir el VPS únicamente por una cifra de RAM.

Cuándo conviene utilizar 8 GB de RAM o más

Personalmente, preferiría disponer de 8 GB de RAM o más si queremos ejecutar varias aplicaciones en Coolify, trabajar con herramientas de automatización o mantener procesos adicionales.

Por ejemplo, podemos necesitar más recursos si incorporamos navegadores automatizados, servicios auxiliares, bases de datos o varias instancias de agentes.

También debemos considerar el procesador y el almacenamiento.

No tendría mucho sentido ampliar únicamente la RAM si nuestro principal cuello de botella es la CPU o el disco.

Por eso es importante analizar qué componentes forman parte de la instalación completa.

Diferencias entre utilizar modelos externos y ejecutar herramientas exigentes

Cuando Hermes se conecta con un proveedor externo, el modelo procesa las solicitudes en la infraestructura de ese proveedor.

Nuestro VPS ejecuta principalmente el agente y las herramientas que configuremos.

En cambio, si añadimos inferencia local, los requisitos pueden aumentar considerablemente.

Lo mismo ocurre con herramientas que utilizan navegadores, procesan archivos pesados o mantienen muchos procesos simultáneos.

Por tanto, Hermes Agent es una cosa y los recursos que necesitan sus herramientas son otra.

No debemos dimensionar nuestro servidor pensando únicamente en arrancar el agente, sino en todo lo que queremos pedirle.

Errores frecuentes al instalar Hermes Agent en Coolify

Aunque Docker Compose simplifica el despliegue, pueden aparecer problemas de configuración, almacenamiento o conectividad.

La ventaja de Coolify es que nos permite consultar los registros y administrar el servicio desde su panel.

Aun así, es conveniente entender qué debemos revisar cuando algo falla.

El contenedor se detiene o se reinicia continuamente

Si Hermes Agent no consigue arrancar, empezaría consultando sus registros.

Podemos comprobar el estado mediante:

docker ps -a

Y revisar los últimos mensajes:

docker logs --tail 100 NOMBRE_CONTENEDOR

Las posibles causas incluyen archivos de configuración incorrectos, problemas de permisos o parámetros de inicio incompatibles.

También revisaría que no hayamos modificado innecesariamente el entrypoint de la imagen oficial.

Hermes utiliza un sistema de supervisión interno, por lo que alterar su proceso de entrada puede introducir problemas adicionales.

Hermes Agent no reconoce las credenciales del modelo

Si el agente arranca, pero no consigue comunicarse con el proveedor de inteligencia artificial, debemos revisar la configuración del modelo.

Comprobaría que la API key es válida, que el proveedor seleccionado es correcto y que nuestra cuenta permite utilizar el modelo elegido.

También revisaría la conectividad del servidor.

En ocasiones, un error que parece relacionado con Hermes procede realmente del proveedor externo, de un límite de uso o de una configuración de red.

No recomiendo cambiar varias claves o variables al mismo tiempo. Es preferible modificar un elemento, volver a probar y observar el resultado.

Problemas con los permisos o el almacenamiento persistente

Si aparecen mensajes Permission denied, conviene revisar quién es el propietario del directorio persistente.

Por ejemplo:

sudo ls -ld /opt/hermes-agent/data

La imagen oficial utiliza por defecto un usuario interno sin privilegios para ejecutar sus servicios.

Dependiendo de la configuración, puede ser necesario ajustar el propietario del directorio o utilizar las variables de UID y GID admitidas por la imagen.

La documentación de Hermes describe mecanismos como HERMES_UID, HERMES_GID, PUID y PGID.

Lo importante es resolver correctamente la correspondencia de permisos entre el host y el contenedor.

No debemos abrir indiscriminadamente los permisos del directorio, porque contiene información sensible.

Tabla rápida de problemas y soluciones

ProblemaQué comprobar
El contenedor no arrancaLogs, imagen y configuración
Reinicios continuosErrores de inicio y archivos persistentes
Fallo de autenticación del modeloAPI key, proveedor y permisos de la cuenta
Permission deniedPropietario, UID, GID y montaje del directorio
Se pierden datos tras actualizarRuta del volumen persistente
El dashboard no respondeActivación, autenticación y red
Consumo elevado de RAMHerramientas, navegadores y servicios adicionales

Cómo actualizar y mantener Hermes Agent desde Coolify

Una de las razones por las que me gusta utilizar Coolify es que podemos centralizar buena parte del mantenimiento de nuestros servicios.

Eso no significa que debamos actualizar automáticamente todas las imágenes sin revisar los cambios.

Con un agente capaz de ejecutar herramientas y almacenar credenciales, prefiero tratar las actualizaciones con cierta precaución.

Actualizar la imagen Docker sin perder los datos

Antes de actualizar Hermes Agent, revisaría las notas de la nueva versión y comprobaría que nuestra configuración sigue siendo compatible.

Después realizaría una copia de seguridad del directorio persistente.

Como ejemplo de copia manual, podemos utilizar:

sudo tar -czf \
  /root/hermes-agent-backup.tar.gz \
  -C /opt/hermes-agent data

Este comando crea un archivo comprimido con el contenido del directorio data.

Debemos guardar esa copia en una ubicación protegida y, preferiblemente, fuera del VPS. También conviene comprobar que podemos restaurarla.

Una vez protegida la información, podemos actualizar la imagen desde las opciones disponibles en nuestro despliegue de Coolify.

Si utilizamos latest, debemos recordar que la versión descargada puede cambiar.

Si hemos fijado una versión concreta, tendremos que modificar explícitamente la referencia cuando queramos actualizarla.

Después del despliegue, volveremos a comprobar el estado del contenedor, los registros y las funciones principales.

Revisar los registros y realizar copias de seguridad

Para mí, mantener una aplicación no consiste únicamente en actualizarla.

También implica comprobar que sigue funcionando como esperamos.

Revisaría periódicamente el uso de recursos, los errores de conectividad, el espacio en disco y la situación de las copias de seguridad.

Además, tendría en cuenta que el directorio persistente puede contener información sensible.

Las copias deben protegerse igual que los datos originales: acceso restringido, almacenamiento adecuado y una política de conservación.

Cuando la instalación crezca, podemos incorporar supervisión adicional y procedimientos de recuperación.

No necesitamos hacerlo todo el primer día, pero sí conviene diseñar el entorno pensando en su mantenimiento.

Dudas de la comunidad

¿Se puede instalar Hermes Agent en cualquier VPS?

Podemos instalar Hermes Agent en un VPS compatible con los requisitos del software y la arquitectura de contenedores utilizada.

Para seguir esta guía necesitamos un servidor que permita ejecutar Docker y que disponga de Coolify funcionando.

También debemos comprobar los recursos disponibles y las restricciones del proveedor.

¿Es obligatorio configurar un dominio para Hermes Agent?

No. Para comenzar con un gateway privado y determinadas integraciones no necesitamos publicar un dominio propio.

Si queremos acceder a una interfaz web desde Internet, tendremos que configurar adecuadamente el dominio, HTTPS, autenticación y restricciones de acceso.

No publicaría el dashboard sin preparar antes esas protecciones.

¿Hermes Agent es gratuito o necesita una API de pago?

Debemos distinguir entre el software del agente y el servicio de inteligencia artificial que utilicemos.

Podemos ejecutar Hermes Agent en nuestra infraestructura, pero los proveedores de modelos pueden cobrar por las solicitudes o establecer límites de uso.

También tendremos que considerar el coste del VPS.

¿Puedo conectar Hermes Agent con otras aplicaciones de Coolify?

Sí, podemos diseñar una infraestructura donde Hermes Agent interactúe con otros servicios, siempre que las aplicaciones dispongan de mecanismos de comunicación compatibles.

Por ejemplo, podríamos desplegar una API propia o un servicio auxiliar y configurar una red Docker adecuada.

No recomiendo conectar indiscriminadamente todas las aplicaciones. Es preferible habilitar únicamente las comunicaciones necesarias.

Un agente de IA en tu propio VPS, bajo tu control

Lo que más me gusta de combinar Hermes Agent con Coolify es que no estamos instalando únicamente otra herramienta de inteligencia artificial.

Estamos preparando una base para construir un entorno propio de automatización.

Podemos comenzar con un agente conectado a un proveedor de modelos, mantener sus datos en un volumen persistente y administrar su contenedor desde Coolify.

Después, conforme descubramos nuevas necesidades, podemos añadir herramientas, aplicaciones e integraciones.

Todo ello sin tener que gestionar cada servicio como si fuera un servidor completamente independiente.

Eso sí, no debemos confundir facilidad de despliegue con ausencia de mantenimiento.

Un agente capaz de ejecutar comandos, trabajar con archivos o comunicarse con aplicaciones externas necesita una configuración responsable.

Por eso prefiero empezar con un despliegue sencillo, comprobar que realmente funciona, proteger sus datos y añadir únicamente las capacidades que vayamos a utilizar.

Al final, creo que esa es la parte más interesante de proyectos como Hermes Agent: dejar de utilizar la inteligencia artificial solamente para conversar y empezar a incorporarla a nuestros propios procesos de trabajo.

Y si podemos hacerlo desde un VPS administrado con Coolify, tenemos una buena base para seguir experimentando sin perder de vista la estabilidad, el control y la seguridad.

Opinión Personal

Las herramientas como Hermes Agent representan uno de los cambios más interesantes que estamos viviendo con la inteligencia artificial. Estamos pasando de utilizar la IA simplemente para hacer preguntas a tener agentes capaces de ayudarnos con tareas reales, automatizar procesos y trabajar directamente con nuestras propias herramientas.

Y precisamente por eso me parece tan interesante combinar Hermes Agent con Coolify en un VPS.

Lo que más valoro de esta combinación es la libertad que nos ofrece. Podemos administrar nuestra propia infraestructura, controlar dónde se almacenan los datos y decidir qué herramientas y permisos concedemos al agente. Además, Coolify nos facilita bastante la gestión de los contenedores, los registros y las actualizaciones.

Eso sí, tampoco quiero transmitir la idea de que instalar un agente de IA sea simplemente copiar cuatro comandos y olvidarnos del asunto. Una cosa es conseguir que Hermes Agent arranque y otra muy diferente es mantenerlo funcionando de forma estable y segura. Y creo que ahí está precisamente la diferencia entre experimentar con una herramienta y aprovecharla de verdad.

Mi recomendación es empezar poco a poco. Primero conseguir que funcione, después comprobar que conserva correctamente sus datos y, finalmente, incorporar las integraciones que realmente vayamos a utilizar. No necesitamos darle acceso a todo nuestro servidor ni activar todas sus funciones desde el primer día.

En definitiva, considero que instalar Hermes Agent en Coolify es una opción muy interesante para quienes queremos experimentar con agentes de inteligencia artificial sin renunciar al control de nuestra infraestructura. Y lo mejor es que podemos comenzar con algo sencillo e ir construyendo un entorno de automatización cada vez más completo.

¿Y tú qué opinas?

Me gustaría conocer tu experiencia. ¿Has probado ya Hermes Agent? ¿Lo instalarías en Coolify o prefieres administrarlo directamente con Docker?

Si has conseguido ponerlo en marcha, has encontrado algún problema durante la instalación o conoces algún truco que pueda facilitar el proceso, ¡cuéntamelo en los comentarios!

Seguro que entre todos podemos compartir ideas, resolver dudas y descubrir nuevas formas de sacar partido a Hermes Agent. ¡Te leo!

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *