Alojar Ryot en un VPS administrado: sus contenidos y su entrenamiento

Alojar Ryot en un VPS administrado significa guardar el historial de lo que ve, lee, juega y entrena en un servidor propio, que nuestros equipos mantienen actualizado y supervisan día y noche. Ryot es una aplicación de seguimiento libre y de código abierto con licencia GPL-3.0, para películas, series, libros, juegos, pódcasts, música y entrenamientos. Esta guía sigue su imagen Docker oficial, en la versión v10.5.8, y ejecutamos cada comando en un VPS de Simafri antes de escribirla: la instalación con Docker Compose y PostgreSQL, HTTPS, la primera cuenta, las claves de API de cada tipo de contenido, las copias de seguridad y las actualizaciones.

Simon Vasconcelos Lee Por Publicado el 19 de noviembre de 202611 minutos de lectura

Todas las guías

Lo esencial

  1. La licencia GPL-3.0 le permite ejecutar Ryot para usted, su familia o su club sin ninguna licencia que comprar; Ryot Pro, una clave de pago, añade funciones sobre la misma imagen.
  2. Instálelo con Docker Compose: la imagen ignisda/ryot y PostgreSQL 18, con el puerto 8000 publicado en 127.0.0.1 detrás de un proxy inverso en HTTPS.
  3. Ponga la contraseña de la base de datos y SERVER_ADMIN_ACCESS_TOKEN en un archivo .env, y defina FRONTEND_URL con su dirección pública.
  4. La primera cuenta que cree se convierte en la del administrador; después, defina USERS_ALLOW_REGISTRATION=false para cerrar los registros en una instancia privada.
  5. Los libros funcionan de inmediato; las películas y las series necesitan un token de TMDB, los videojuegos una aplicación de Twitch. Haga copia con pg_dump y actualice cambiando la etiqueta de la imagen.

Qué hace Ryot

Ryot, por «Roll Your Own Tracker», y que se pronuncia «riot», reúne en un solo lugar lo que ha visto, leído, jugado y entrenado, con estadísticas, un calendario de lo que está por llegar y colecciones propias. Su desarrollador, IgnisDa, lo escribe en Rust, con una interfaz web que se puede instalar en un teléfono como una aplicación.

Lo que permite la licencia GPL-3.0

Ryot se publica con la GNU General Public License, versión 3 (GPL-3.0). Puede usarlo de forma gratuita, para usted, su familia, su club o su empresa, copiarlo y modificarlo. Si distribuye una versión modificada, distribuye su código fuente con la misma licencia. El software se ofrece sin garantía.

Ryot Pro es una clave de pago que vende su desarrollador y que desbloquea funciones adicionales, como el uso compartido de perfiles y las recomendaciones personalizadas. Va en una variable SERVER_PRO_KEY de la misma imagen, y el servidor vuelve a la versión comunitaria si la clave caduca. Nada en esta guía la necesita.

Los recursos que hay que prever

La documentación no fija ningún tamaño mínimo, y Ryot es ligero. Esto es lo que medimos en nuestro VPS de prueba, recién instalado:

El tamaño del servidor depende, por tanto, del número de usuarios y de las demás aplicaciones que ejecute junto a Ryot. En un VPS administrado, cuéntenos su uso y le recomendaremos el tamaño adecuado.

La instalación con Docker Compose

Ryot se distribuye como una sola imagen, ignisda/ryot, publicada también como ghcr.io/ignisda/ryot, que sirve a la vez la interfaz y la API en el puerto 8000. Necesita PostgreSQL 15 o posterior, que funciona a su lado en su propio contenedor. En un servidor con Docker Engine y su plugin Compose, instalados desde el repositorio de Docker para Ubuntu, cree una carpeta como /opt/ryot y coloque en ella este compose.yaml, basado en el archivo de la página de instalación:

compose.yaml
services:
  ryot-db:
    image: postgres:18-alpine
    restart: unless-stopped
    environment:
      - TZ=Europe/Amsterdam
      - POSTGRES_DB=ryot
      - POSTGRES_USER=ryot
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env}
    volumes:
      - postgres_storage:/var/lib/postgresql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ryot -d ryot"]
      interval: 5s
      timeout: 5s
      retries: 10

  ryot:
    image: ignisda/ryot:v10.5.8
    restart: unless-stopped
    ports:
      - "127.0.0.1:8000:8000"
    environment:
      - TZ=Europe/Amsterdam
      - FRONTEND_URL=https://ryot.example.com
      - DATABASE_URL=postgres://ryot:${POSTGRES_PASSWORD}@ryot-db:5432/ryot
      - SERVER_ADMIN_ACCESS_TOKEN=${SERVER_ADMIN_ACCESS_TOKEN:?set SERVER_ADMIN_ACCESS_TOKEN in .env}
    depends_on:
      ryot-db:
        condition: service_healthy

volumes:
  postgres_storage:

Los dos secretos van en un archivo .env situado al lado, que Docker Compose lee por sí mismo. Créelo legible solo por root y después inicie el conjunto:

Terminal, en /opt/ryot
umask 077
printf 'POSTGRES_PASSWORD=%s\nSERVER_ADMIN_ACCESS_TOKEN=%s\n' "$(openssl rand -hex 24)" "$(openssl rand -hex 32)" > .env
umask 022
docker compose up -d
docker compose ps

El primer inicio ejecuta las migraciones de la base de datos y descarga el catálogo de ejercicios; en nuestro VPS de prueba, Ryot respondió en pocos segundos. Para comprobar que responde:

Terminal
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8000/health
curl -s http://127.0.0.1:8000/backend/config | head -c 300

El primer comando responde 200. El segundo devuelve la configuración que ha cargado el servidor, en JSON, con sus secretos ocultos: una forma práctica de comprobar una variable.

HTTPS: el proxy inverso

El contenedor sirve Ryot en HTTP, en el puerto 8000. HTTPS corre a cargo de un proxy inverso situado delante, que debe transmitir la cabecera Host pública y X-Forwarded-Proto. Probamos Caddy, instalado desde su repositorio oficial para Debian y Ubuntu: obtiene por sí mismo el certificado de Let’s Encrypt, lo renueva, y transmite estas cabeceras por defecto.

/etc/caddy/Caddyfile
ryot.example.com {
	reverse_proxy 127.0.0.1:8000
}
Terminal
sudo systemctl reload caddy

La primera cuenta, los registros y las invitaciones

Ryot no tiene cuenta por defecto, y los registros están abiertos en una instancia nueva. La primera cuenta creada recibe el rol Admin; las siguientes son usuarios normales. Cree la suya justo después del primer inicio:

  1. Abra su dirección: Ryot muestra su página de inicio de sesión.
  2. Haga clic en «Create a new account?» y después introduzca un nombre de usuario y dos veces una contraseña.
  3. Regístrese y después inicie sesión con sus nuevas credenciales: llega al panel, con una visita guiada de bienvenida.
  4. En «Settings», «Users», su cuenta aparece con el rol Admin.

Para una instancia privada, cierre los registros: añada USERS_ALLOW_REGISTRATION=false al entorno del servicio ryot y después ejecute docker compose up -d. En nuestro VPS de prueba, el enlace «Create a new account?» desapareció, y un intento de registro desde la dirección de registro fue rechazado por el servidor con «Registration is disabled».

Invitar a los demás usuarios

  1. En «Settings», «Users», haga clic en el botón + junto al título.
  2. Introduzca el nombre de usuario de la persona: Ryot crea la cuenta y muestra un enlace de un solo uso.
  3. Envíe el enlace: la persona lo abre, elige una contraseña y después inicia sesión.

Lo probamos con los registros cerrados: la cuenta invitada se creó como usuario normal, su contraseña se definió desde el enlace, y llegó a su propio panel.

Para iniciar sesión con las cuentas de su empresa, Ryot admite OpenID Connect: defina SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET y SERVER_OIDC_ISSUER_URL, y declare https://ryot.example.com/api/auth como dirección de redirección en su proveedor.

Películas, series y juegos: las claves de API

Ryot obtiene los detalles y las portadas de cada tipo de contenido de un proveedor. Algunos funcionan sin clave, otros necesitan la suya, ya que las claves compartidas se retiraron en la v9:

ContenidoProveedorLo que hay que definir
LibrosOpen LibraryNada: funciona de inmediato. Google Books y Hardcover son opcionales, con su clave de API
Películas y seriesTMDB, o TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, el API Read Access Token de una cuenta gratuita de TMDB, o MOVIES_AND_SHOWS_TVDB_API_KEY
VideojuegosIGDB, a través de TwitchVIDEO_GAMES_TWITCH_CLIENT_ID y VIDEO_GAMES_TWITCH_CLIENT_SECRET, de una aplicación en la consola de desarrolladores de Twitch
MúsicaSpotify, opcionalMUSIC_SPOTIFY_CLIENT_ID y MUSIC_SPOTIFY_CLIENT_SECRET
Importación de animeMyAnimeListANIME_AND_MANGA_MAL_CLIENT_ID, necesario solo para importar desde MyAnimeList

Estas claves son secretos: póngalas en el archivo .env, añada una línea como - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} al entorno del servicio ryot y después ejecute docker compose up -d. La página de configuración de la documentación enumera todas las demás variables.

Las copias de seguridad

Todo se encuentra en dos lugares: la base de datos PostgreSQL, en el volumen postgres_storage, y su archivo .env. Guarde este último en lugar seguro: SERVER_ADMIN_ACCESS_TOKEN es necesario para leer los secretos de doble autenticación guardados en la base de datos. La imagen de PostgreSQL incluye pg_dump. El volcado contiene todas las cuentas y su historial, así que créelo legible solo por root, con umask 077 entre paréntesis: el resto de su sesión conserva su máscara habitual. Un archivo que ya existe conserva sus permisos cuando se sobrescribe, así que la línea find cierra primero los volcados y las copias que ya están en la carpeta, antes de escribir nada, y detiene la copia de seguridad si no lo consigue:

Terminal, en /opt/ryot
(
  umask 077
  find . -maxdepth 1 \( -name 'ryot-*.dump' -o -name 'env-*.bak' \) -exec chmod 600 {} + || exit 1
  docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot > ryot-$(date +%F).dump
  cp .env env-$(date +%F).bak
)

Programe esta copia y envíela fuera del servidor. Guardados en el disco, los volcados entran también en las copias de seguridad nocturnas del servidor.

La restauración

En la misma instalación o en una nueva, con el mismo .env, detenga la aplicación, sustituya la base de datos por una vacía, cargue en ella el volcado y vuelva a iniciar la aplicación:

Terminal, en /opt/ryot
docker compose stop ryot &&
docker compose exec -T ryot-db dropdb -U ryot ryot &&
docker compose exec -T ryot-db createdb -U ryot ryot &&
docker compose exec -T ryot-db pg_restore -U ryot -d ryot --exit-on-error --no-owner < ryot-2026-11-20.dump &&
docker compose start ryot

Probamos el ciclo completo en nuestro VPS con estos mismos comandos: volcado, base de datos eliminada y vuelta a crear vacía, restauración. Las dos cuentas, sus colecciones y los 876 ejercicios volvieron, y el administrador inició sesión de nuevo al instante.

Ryot exporta también sus propios datos en JSON, desde la página de ajustes «Imports and Exports», y puede volver a importarlos. Esa exportación necesita un almacenamiento de archivos compatible con S3; el volcado de la base de datos anterior funciona sin él.

Las actualizaciones

Ryot publica versiones a menudo, más o menos cada semana. Lea la nota de versión, haga una copia de seguridad, cambie la etiqueta de la imagen en el compose.yaml, y después descargue la nueva imagen y recree el contenedor. Las migraciones de la base de datos se ejecutan solas al iniciar:

Terminal, en /opt/ryot
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration

La telemetría

Ryot recoge datos de uso anónimos, páginas vistas y algunos eventos, en una instancia Umami autoalojada por su desarrollador. Para desactivarla, añada DISABLE_TELEMETRY=true al entorno del servicio ryot y después ejecute docker compose up -d.

Quién hace qué en un VPS administrado

El autoalojamiento exige mantener el servidor además de la aplicación. En un VPS administrado, nuestros equipos se encargan del servidor y siguen su instancia de forma proactiva; Ryot sigue siendo su software, con su historial y sus ajustes.

TemaNuestros equiposUsted
El servidorActualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidasEl momento que mejor le convenga
La supervisiónServidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamadaSu historial, sus colecciones y sus integraciones en Ryot
RyotSeguimiento proactivo: errores, lentitud, base de datos y espacio en disco detectados, corrección recomendadaSu instalación, sus actualizaciones, sus claves de API y sus ajustes, que aplica usted o su asistente de IA
Los usuariosEl servidor que los soporta, vigilado y con copias de seguridadLas cuentas, los registros y el inicio de sesión único
Las copias de seguridadCada noche, cifradas y guardadas fuera de la máquina; restauración incluidaLos volcados de base de datos y las exportaciones JSON propios de Ryot, y la petición de restauración, cuando la necesite
La migraciónSu servidor actual migrado, gratisEl momento del cambio

Si prefiere que nuestros equipos intervengan en la propia aplicación, ese servicio se factura por horas o a precio cerrado, con un presupuesto comunicado antes de la intervención.

Ryot, en un servidor que cuidamos por usted

Con un VPS administrado de Simafri, nuestros equipos mantienen actualizado el servidor de su instancia de Ryot, lo vigilan día y noche e intervienen sin esperar su llamada; también siguen su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted o su asistente de IA. Las copias de seguridad se cifran cada noche y se guardan fuera de la máquina, su restauración está incluida, y la migración de su servidor actual es gratuita.

Descubrir los VPS administrados

Preguntas frecuentes

¿Ryot es gratuito?

Sí. Ryot tiene licencia GPL-3.0: puede ejecutarlo para usted, su familia o su equipo sin ninguna licencia que comprar. Ryot Pro es una clave de pago opcional que añade funciones a la misma imagen. Queda el coste del servidor que lo ejecuta.

¿Cómo instalar Ryot con Docker Compose?

Use la imagen ignisda/ryot y PostgreSQL 18 en un compose.yaml. Ponga la contraseña de la base de datos y SERVER_ADMIN_ACCESS_TOKEN en un archivo .env, defina FRONTEND_URL con su dirección https, publique el puerto 8000 en 127.0.0.1, ejecute docker compose up -d y coloque delante un proxy inverso en HTTPS.

¿Cuáles son los accesos por defecto de Ryot?

No hay ninguno. Haga clic en «Create a new account?» en la página de inicio de sesión: la primera cuenta creada se convierte en la del administrador. Después, defina USERS_ALLOW_REGISTRATION=false para cerrar los registros; el administrador invita a los demás usuarios desde Settings, Users, con un enlace de un solo uso.

¿Por qué Ryot no encuentra películas ni series?

Desde la v9, las películas y las series necesitan su propio token de TMDB: cree una cuenta gratuita de TMDB, solicite una clave de API y ponga su API Read Access Token en MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Los videojuegos necesitan una aplicación de Twitch, mientras que los libros funcionan sin ninguna clave.

¿Cuánta memoria necesita Ryot?

Poca. En nuestro VPS de prueba, una instalación nueva usaba entre unos 240 y 300 MB para Ryot y 70 MB para PostgreSQL, y las dos imágenes ocupan unos 810 MB de disco.

¿Cómo hacer copia de seguridad de Ryot?

Vuelque la base de datos PostgreSQL con docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot bajo umask 077, para que solo root pueda leerla, y conserve una copia de su archivo .env. Para restaurar, detenga la aplicación, vuelva a crear la base de datos vacía con dropdb y createdb, y después cargue el volcado con pg_restore --exit-on-error --no-owner.

¿Cómo actualizar Ryot?

Lea la nota de versión y haga una copia de seguridad, cambie la etiqueta de la imagen en compose.yaml, y después ejecute docker compose pull y docker compose up -d. Las migraciones de la base de datos se ejecutan solas al iniciar. Entre versiones mayores, siga la página de migración.

¿Un VPS administrado cubre Ryot?

Un VPS administrado cubre el servidor: sistema, seguridad, supervisión y copias de seguridad. Nuestros equipos siguen también su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted. Una intervención en la aplicación se factura por horas o a precio cerrado.

Guías relacionadas

Alojar PostgreSQL en un VPS: dimensionar memoria y discoUna base PostgreSQL rápida es una base cuyos datos consultados con frecuencia caben en memoria. Todo el dimensionamiento parte de ahí: el volumen de la base, la parte que trabaja realmente, el número de conexiones y, después, el disco y su margen. Esta guía da el método, los ajustes de partida para 4, 8 y 16 GB de memoria, y las consultas que miden una base existente.Copias de seguridad de un VPS: qué comprobar antes de contratarUna oferta de VPS anuncia casi siempre «copias de seguridad incluidas». Detrás de estas palabras puede haber una copia cada noche, guardada fuera de la máquina y restaurada por expertos, o una instantánea situada en el mismo disco que el servidor. Esta guía da las preguntas que marcan la diferencia, lo que significa cada respuesta y la forma de comprobar que una copia de seguridad se restaura.Alojar Actual Budget en un VPS administrado: sus presupuestos en su servidorAlojar Actual Budget en un VPS administrado significa guardar sus presupuestos y su sincronización en una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. Actual Budget es una herramienta de finanzas personales que da prioridad a los datos locales, publicada con licencia MIT. Esta guía sigue su documentación oficial: el papel del servidor, la instalación con Docker Compose, HTTPS, la contraseña del servidor, OpenID, el cifrado de extremo a extremo, la sincronización bancaria, las copias de seguridad y las actualizaciones.
Contáctenos