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.
Por Simon Vasconcelos Lee
Publicado el 19 de noviembre de 202611 minutos de lectura
ignisda/ryot y PostgreSQL 18, con el puerto 8000 publicado en 127.0.0.1 detrás de un proxy inverso en HTTPS.SERVER_ADMIN_ACCESS_TOKEN en un archivo .env, y defina FRONTEND_URL con su dirección pública.USERS_ALLOW_REGISTRATION=false para cerrar los registros en una instancia privada.pg_dump y actualice cambiando la etiqueta de la imagen.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.
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.
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.
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:
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:
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
127.0.0.1: el archivo de referencia lo publica sin dirección, y Docker lo abre entonces en todas las direcciones del servidor. Publicado en local, solo es accesible a través del proxy inverso.postgres como usuario y contraseña. Aquí, un usuario dedicado ryot recibe una contraseña aleatoria, en hexadecimal para que no necesite ningún escape en DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN es obligatorio: autoriza las operaciones de administrador a través de la API y cifra los secretos de autenticación en dos pasos de sus usuarios. Manténgalo en secreto y estable: con otro token, esos secretos ya no se pueden leer.FRONTEND_URL es su dirección pública, con https://. Ryot la usa como base de los enlaces que genera, y OpenID Connect la necesita.TZ es la zona horaria de las tareas programadas, GMT por defecto: ponga la suya, de la lista IANA.v10 con pull_policy: always, que sigue cada versión menor en cada inicio. Una versión completa, aquí v10.5.8, le permite elegir el momento de cada actualización.postgres_storage contiene todos sus datos. PostgreSQL 18 los guarda en /var/lib/postgresql, por eso el volumen se monta ahí y no en /var/lib/postgresql/data como con las versiones anteriores.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:
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.
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.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.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:
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».
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.
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:
| Contenido | Proveedor | Lo que hay que definir |
|---|---|---|
| Libros | Open Library | Nada: funciona de inmediato. Google Books y Hardcover son opcionales, con su clave de API |
| Películas y series | TMDB, o TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, el API Read Access Token de una cuenta gratuita de TMDB, o MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videojuegos | IGDB, a través de Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID y VIDEO_GAMES_TWITCH_CLIENT_SECRET, de una aplicación en la consola de desarrolladores de Twitch |
| Música | Spotify, opcional | MUSIC_SPOTIFY_CLIENT_ID y MUSIC_SPOTIFY_CLIENT_SECRET |
| Importación de anime | MyAnimeList | ANIME_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.
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:
(
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.
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:
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
--exit-on-error detiene la restauración en el primer error, en lugar de continuar e informar de los errores al final, y los && detienen ahí la secuencia: Ryot sigue detenido. Lo que se cargó antes del error permanece en la base de datos, así que vuelva a empezar desde dropdb una vez corregida la causa.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.
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:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop sigue la rama principal: la documentación advierte de que a menudo tiene errores graves y puede perder datos. Quédese en las versiones publicadas.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.
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.
| Tema | Nuestros equipos | Usted |
|---|---|---|
| El servidor | Actualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidas | El momento que mejor le convenga |
| La supervisión | Servidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamada | Su historial, sus colecciones y sus integraciones en Ryot |
| Ryot | Seguimiento proactivo: errores, lentitud, base de datos y espacio en disco detectados, corrección recomendada | Su instalación, sus actualizaciones, sus claves de API y sus ajustes, que aplica usted o su asistente de IA |
| Los usuarios | El servidor que los soporta, vigilado y con copias de seguridad | Las cuentas, los registros y el inicio de sesión único |
| Las copias de seguridad | Cada noche, cifradas y guardadas fuera de la máquina; restauración incluida | Los volcados de base de datos y las exportaciones JSON propios de Ryot, y la petición de restauración, cuando la necesite |
| La migración | Su servidor actual migrado, gratis | El 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.
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.
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.
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.
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.
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.
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.
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.
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 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.
Simafri
Hablemos de su proyecto
Díganos en pocas palabras lo que necesita: le respondemos rápidamente.
¡Gracias! Su solicitud ha sido enviada. Le responderemos en breve.
¿Prefiere el correo? Escríbanos a support@simafri.com.