Cómo autoalojar Hoard con Docker (self-hosted)

Hoard es de código abierto y se puede autoalojar. En lugar de usar Hoard Cloud, puedes ejecutar el mismo hoard-server en tu propia máquina y apuntar todos tus dispositivos a él: sin cuenta y sin más límite de espacio que el disco que le des. Esta guía deja un servidor funcionando con Docker en pocos minutos.

Por qué autoalojar Hoard

• Control total. Tus partidas viven en hardware que tú controlas, no en la nube de otro.
• Sin cuota. El espacio solo lo limita tu propio disco.
• La misma app, las mismas funciones. El historial versionado y la sincronización en segundo plano funcionan igual que con Hoard Cloud; solo cambia el backend.
• Código abierto. Puedes leer, auditar y modificar el servidor.

Esta es la diferencia clave frente a herramientas como Ludusavi: Ludusavi es excelente para copias locales y para usar tu propia nube vía Rclone, pero la sincronización la montas tú. Hoard te da un servidor de sincronización gestionado que arrancas una vez y al que se conectan todos los dispositivos.

Qué significa autoalojarse para tus datos

Conviene decirlo sin rodeos, porque es lo que casi todas las comparativas se equivocan sobre Hoard.

Hoard Cloud es la opción gestionada: inicias sesión y tus partidas están en nuestros servidores, en la UE.

Un Hoard autoalojado es tuyo por completo. Tus dispositivos hablan con tu servidor y con nada más. No hay cuenta con nosotros, ni telemetría hacia nosotros, ni cupo, ni relé: no pasa nada por nuestros servidores, porque no hay nada nuestro en el camino. No podemos ver una partida, ni el nombre de un juego, ni un correo, por la sencilla razón de que nada de eso nos llega. Si Hoard Cloud cerrara mañana, tu montaje seguiría funcionando igual.

Y para ser exactos en una cosa: tu servidor sí tiene sus propios accesos — el usuario que crearás más abajo y un token por dispositivo. Son tuyos, en tu máquina, en tu base de datos. Lo que no existe es una cuenta con nosotros.

Qué necesitas

• Una máquina que esté siempre encendida (un servidor casero, un NAS que ejecute Docker o un VPS pequeño).
• Docker y Docker Compose instalados (en un NAS Synology, el paquete Container Manager).
• Opcionalmente un dominio y un proxy inverso para HTTPS (recomendado para cualquier cosa fuera de tu red local).

Instalación con Docker Compose

No hace falta clonar el repositorio. El servidor es una imagen ya compilada (ghcr.io/rleeon/hoard, amd64 y arm64), y lo único que descargas es su docker-compose.yml:

mkdir hoard && cd hoard
curl -O https://raw.githubusercontent.com/rleeon/hoard/main/deploy/docker/docker-compose.yml

# Used only on the first start: they create that admin and print a device token in the log, once
HOARD_ADMIN_USERNAME=alice HOARD_ADMIN_PASSWORD='CHANGE_ME' docker compose up -d
docker compose logs -f server                  # wait for "listening", then copy the token

En el primer arranque el contenedor escribe un config.toml funcional en ./config/, junto al fichero de compose, así que con docker compose a secas no hay nada que preparar. Los datos se guardan en un volumen de Docker (hoard-data); haz copia de seguridad como con cualquier otro volumen. El contenedor escucha internamente en el puerto 12421; usa otro puerto del host con HOARD_PORT=9000 docker compose up -d.

Si prefieres leer la configuración antes de arrancar nada, o compilar la imagen tú mismo, la guía de self-hosting del repositorio explica cómo clonarlo.

En un NAS Synology (Container Manager)

Container Manager no tiene línea de comandos donde pasar esas dos variables, y se niega a arrancar un proyecto mientras falte alguna de las carpetas que monta: es el error Bind mount failed: '…/config' does not exist. Cuatro pasos resuelven las dos cosas:

1. En File Station, crea una carpeta para Hoard (por ejemplo docker/hoard) y, dentro, una carpeta config vacía.

2. En Container Manager, abre Project → Create, elige esa carpeta como ruta, indica que quieres crear un docker-compose.yml y pega el contenido del fichero (para verlo, abre en el navegador la URL de la línea curl de arriba).

3. En el fichero pegado, sustituye ${HOARD_ADMIN_USERNAME:-} y ${HOARD_ADMIN_PASSWORD:-} por el usuario y la contraseña de tu administrador, sin tocar el resto de cada línea, para que queden así:

   HOARD_ADMIN_USERNAME: alice
   HOARD_ADMIN_PASSWORD: 'CHANGE_ME'
   

4. Termina el asistente para arrancarlo y abre el registro de hoard-server en Container: ahí aparece el token de dispositivo, una sola vez.

Con el fichero tal cual, las partidas se guardan en el almacenamiento propio de Docker, fuera de tus carpetas compartidas. Para tenerlas en una carpeta compartida de la que ya haces copia, crea también una carpeta data junto a config y cambia la línea hoard-data:/var/lib/hoard por ./data:/var/lib/hoard.

Crea tu usuario y un token de dispositivo

Si lo arrancaste con HOARD_ADMIN_USERNAME y HOARD_ADMIN_PASSWORD, esto ya está hecho: el usuario existe y su token está en el log. Si no, créalos por línea de comandos (el servidor no tiene pantalla de registro):

docker compose exec server hoard-admin --config /etc/hoard/config.toml \
    user create alice --admin --password 'CHANGE_ME'
docker compose exec server hoard-admin --config /etc/hoard/config.toml \
    token create alice --device 'desktop'

El token se muestra una sola vez y no se puede recuperar después, así que cópialo ahora. Para cada dispositivo que añadas más adelante no hace falta terminal: abre la dirección de tu servidor en el navegador, entra en el panel web con ese usuario y esa contraseña, y usa Usuarios → Nuevo token.

Conecta la aplicación de escritorio

Instala la app de escritorio de Hoard en cada equipo. En el asistente inicial elige Self-Host, y pega la URL de tu servidor y el token que acabas de crear. A partir de ahí se comporta igual que Hoard Cloud: detecta tus juegos, copia las partidas automáticamente y mantiene el historial versionado. Consulta sincronizar partidas entre varios PC para el día a día.

Mantén tu servidor al día

Cómo se actualiza depende de cómo lo instalaste, y equivocarse de comando no da error: simplemente no hace nada. Merece la pena saber cuál es el tuyo.

Docker Compose. Baja la imagen nueva y recrea el contenedor. Las dos mitades, en orden:

docker compose pull
docker compose up -d

Si te quedas en la primera, el contenedor viejo sigue corriendo intacto: /v1/health sigue informando de la versión antigua y la actualización parece haber fallado en silencio. git pull no actualiza ninguna de las dos: lo que corre es la imagen publicada, no tu copia del repositorio. Fija una versión (ghcr.io/rleeon/hoard:1.1) en lugar de :latest si prefieres elegir tú cuándo llega una nueva.

Unraid. Pestaña Docker → Hoard → Apply update cuando aparezca. No hay nada que teclear.

Bare metal (systemd). sudo hoard-server upgrade y después sudo systemctl restart hoard-server. Cambia el binario de forma atómica y a propósito no reinicia el servicio por su cuenta, para no cortar una sincronización en marcha.

hoard-server upgrade es sólo para la instalación bare metal. Dentro de un contenedor se niega a propósito —el cambio de binario no sobreviviría al siguiente docker compose up -d— e imprime los dos comandos de arriba; ejecuta docker compose exec server hoard-server upgrade si quieres verlo decirlo. Las migraciones de la base de datos las aplica el servidor al arrancar, así que nunca hay un paso aparte para ellas.

Llevarlo a producción

Para cualquier cosa expuesta fuera de tu red local, termina el TLS en un proxy inverso (Caddy, nginx o Traefik). ¿Prefieres bare metal? El repositorio también incluye un script de instalación con systemd y un comando hoard-server upgrade que cambia el binario de forma atómica sin cortar una sincronización en curso.

¿Self-hosted o Hoard Cloud?

Autoalojar es ideal si ya tienes un servidor y quieres control total sin límites. Si prefieres no mantener infraestructura, Hoard Cloud te da la misma sincronización gestionada por nosotros, con un plan gratuito para empezar. En cualquier caso, la app y tus partidas siguen siendo portables: puedes cambiar más adelante.

Preguntas frecuentes

¿Un Hoard autoalojado llama a casa?

No. La aplicación de escritorio habla con la dirección de servidor que tú le des. Tus partidas, tus usuarios y tus registros se quedan en tu máquina, y nada de eso nos llega.

¿El servidor autoalojado es el mismo código que Hoard Cloud?

Sí, el mismo binario hoard-server, bajo AGPL-3.0. No hay una edición comunitaria recortada ni funciones reservadas para la versión alojada.

¿Dónde se guardan realmente las partidas?

Por defecto, en el volumen de Docker que le des al contenedor, en tu propio disco. Si ya tienes almacenamiento de objetos, el servidor también habla S3, así que MinIO, Garage o Backblaze B2 sirven como respaldo. En cualquier caso, tus dispositivos sólo hablan con tu servidor.

¿Puedo montarlo en un NAS?

Sí, en cualquier NAS que ejecute Docker. En Synology, sigue los pasos de Container Manager de arriba; para Unraid, el repositorio incluye una plantilla. En los dos casos la imagen cambia al PUID/PGID que le indiques, para que las carpetas montadas sean del usuario correcto y no de root.

¿Necesito dominio y HTTPS?

En tu propia red local, no. En cuanto el servidor sea accesible desde fuera, pon un proxy inverso delante y termina ahí el TLS: Caddy, nginx o Traefik valen igual.

¿Y si mi servidor está caído cuando termino de jugar?

La instantánea se toma en local, así que no se pierde nada. Se sube sola en cuanto el servidor vuelve a responder.

¿Puedo empezar en Hoard Cloud y mudarme después?

Sí, y en los dos sentidos. Puedes exportarlo todo desde la página de tu cuenta, y la aplicación se puede apuntar a otro servidor sin reinstalar nada.