Héberger Ryot sur un VPS infogéré, c'est garder l'historique de vos films, de vos lectures, de vos jeux et de vos séances de musculation sur un serveur à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Ryot est une application libre de suivi, sous licence GPL-3.0, pour les films, les séries, les livres, les jeux, les podcasts, la musique et les séances de sport. Ce guide suit son image Docker officielle, à la version v10.5.8, et nous avons lancé chaque commande sur un VPS Simafri avant de l'écrire : l'installation avec Docker Compose et PostgreSQL, HTTPS, le premier compte, les clés d'API de chaque type de média, les sauvegardes et les mises à jour.
Par Simon Vasconcelos Lee
Publié le 19 novembre 2026Lecture : 11 minutes
ignisda/ryot et PostgreSQL 18, avec le port 8000 publié sur 127.0.0.1 derrière un proxy inverse en HTTPS.SERVER_ADMIN_ACCESS_TOKEN dans un fichier .env, et réglez FRONTEND_URL sur votre adresse publique.USERS_ALLOW_REGISTRATION=false pour fermer les inscriptions d'une instance privée.pg_dump, puis mettez à jour en changeant l'étiquette de l'image.Ryot, pour « Roll Your Own Tracker », qui se prononce comme « riot », réunit en un seul endroit ce que vous avez vu, lu, joué et pratiqué, avec des statistiques, un calendrier de ce qui arrive et vos propres collections. Son développeur, IgnisDa, l'écrit en Rust, avec une interface web qui s'installe sur un téléphone comme une application.
Ryot est publié sous la GNU General Public License, version 3 (GPL-3.0). Vous pouvez l'utiliser gratuitement, pour vous, votre famille, votre club ou votre entreprise, le copier et le modifier. Si vous distribuez une version modifiée, vous en distribuez le code source sous la même licence. Le logiciel est fourni sans garantie.
Ryot Pro est une clé payante vendue par son développeur, qui débloque des fonctions supplémentaires comme le partage de profil et les recommandations personnalisées. Elle se place dans une variable SERVER_PRO_KEY de la même image, et le serveur revient à la version communautaire si la clé expire. Rien dans ce guide n'en a besoin.
La documentation ne fixe aucune taille minimale, et Ryot est léger. Voici ce que nous avons mesuré sur notre VPS de test, fraîchement installé :
La taille du serveur dépend donc du nombre d'utilisateurs et des autres applications que vous faites tourner à côté de Ryot. Sur un VPS infogéré, décrivez-nous votre usage, et nous vous recommandons la taille qui convient.
Ryot se livre en une seule image, ignisda/ryot, publiée aussi sous ghcr.io/ignisda/ryot, qui sert à la fois l'interface et l'API sur le port 8000. Elle demande PostgreSQL 15 ou plus récent, qui tourne à côté, dans son propre conteneur. Sur un serveur doté de Docker Engine et de son extension Compose, installés depuis le dépôt de Docker pour Ubuntu, créez un dossier comme /opt/ryot et placez-y ce compose.yaml, qui reprend le fichier de la page d'installation :
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:
Les deux secrets vont dans un fichier .env posé à côté, que Docker Compose lit de lui-même. Créez-le lisible par root seul, puis démarrez la pile :
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 : le fichier de référence le publie sans adresse, et Docker l'ouvre alors sur toutes les adresses du serveur. Publié en local, il ne s'atteint que par le proxy inverse.postgres comme utilisateur et comme mot de passe. Ici, un utilisateur dédié ryot reçoit un mot de passe aléatoire, en hexadécimal pour n'avoir rien à échapper dans DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN est obligatoire : il autorise les opérations d'administration par l'API, et il chiffre les secrets de double authentification de vos utilisateurs. Gardez-le secret, et gardez-le stable : avec un autre jeton, ces secrets ne se lisent plus.FRONTEND_URL est votre adresse publique, avec https://. Ryot s'en sert comme base des liens qu'il génère, et OpenID Connect en a besoin.TZ est le fuseau horaire des tâches planifiées, GMT par défaut : mettez le vôtre, tiré de la liste IANA.v10 avec pull_policy: always, qui suit chaque version mineure à chaque démarrage. Une version complète, ici v10.5.8, vous laisse choisir le moment de chaque mise à jour.postgres_storage garde toutes vos données. PostgreSQL 18 les range sous /var/lib/postgresql : c'est pourquoi le volume y est monté, et non sur /var/lib/postgresql/data comme avec les versions plus anciennes.Le premier démarrage lance les migrations de la base et télécharge le catalogue d'exercices ; sur notre VPS de test, Ryot répondait en quelques secondes. Pour vérifier qu'il répond :
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
La première commande répond 200. La seconde renvoie la configuration chargée par le serveur, en JSON, avec ses secrets masqués : un moyen pratique de vérifier une variable.
Le conteneur sert Ryot en HTTP, sur le port 8000. HTTPS se règle sur un proxy inverse placé devant, qui doit transmettre l'en-tête Host public et X-Forwarded-Proto. Nous avons testé Caddy, installé depuis son dépôt officiel pour Debian et Ubuntu : il obtient lui-même le certificat Let's Encrypt, le renouvelle, et transmet ces en-têtes par défaut.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot n'a aucun compte par défaut, et les inscriptions sont ouvertes sur une nouvelle instance. Le premier compte créé reçoit le rôle Admin ; les suivants sont des utilisateurs normaux. Créez le vôtre juste après le premier démarrage :
Pour une instance privée, fermez les inscriptions : ajoutez USERS_ALLOW_REGISTRATION=false à l'environnement du service ryot, puis lancez docker compose up -d. Sur notre VPS de test, le lien « Create a new account? » a disparu, et une inscription tentée depuis l'adresse d'inscription a été refusée par le serveur avec « Registration is disabled ».
Nous l'avons testé avec les inscriptions fermées : le compte invité a été créé comme utilisateur normal, son mot de passe a été choisi depuis le lien, et il a rejoint son propre tableau de bord.
Pour vous connecter plutôt avec les comptes de votre entreprise, Ryot prend en charge OpenID Connect : renseignez SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET et SERVER_OIDC_ISSUER_URL, et déclarez https://ryot.example.com/api/auth comme adresse de redirection chez votre fournisseur.
Ryot trouve les fiches et les couvertures de chaque type de média chez un fournisseur. Certains fonctionnent sans clé, d'autres demandent la vôtre, car les clés partagées ont été retirées dans la v9 :
| Média | Fournisseur | Ce qu'il faut renseigner |
|---|---|---|
| Livres | Open Library | Rien : il fonctionne aussitôt. Google Books et Hardcover sont facultatifs, avec leur clé d'API |
| Films et séries | TMDB, ou TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, le jeton API Read Access Token d'un compte TMDB gratuit, ou MOVIES_AND_SHOWS_TVDB_API_KEY |
| Jeux vidéo | IGDB, par Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID et VIDEO_GAMES_TWITCH_CLIENT_SECRET, tirés d'une application de la console développeur de Twitch |
| Musique | Spotify, facultatif | MUSIC_SPOTIFY_CLIENT_ID et MUSIC_SPOTIFY_CLIENT_SECRET |
| Import d'anime | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, utile seulement pour importer depuis MyAnimeList |
Ces clés sont des secrets : placez-les dans le fichier .env, ajoutez une ligne comme - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} à l'environnement du service ryot, puis lancez docker compose up -d. La page de configuration de la documentation liste toutes les autres variables.
Tout vit à deux endroits : la base PostgreSQL, dans le volume postgres_storage, et votre fichier .env. Gardez ce dernier à l'abri : SERVER_ADMIN_ACCESS_TOKEN sert à lire les secrets de double authentification enregistrés dans la base. L'image PostgreSQL contient pg_dump. Le dump contient chaque compte et son historique : créez-le donc lisible par root seul, avec umask 077 entre parenthèses, et le reste de votre session garde son masque habituel. Un fichier qui existe déjà garde ses droits quand il est écrasé : la ligne find ferme donc d'abord les dumps et les copies déjà présents dans le dossier, avant toute écriture, et arrête la sauvegarde si elle n'y parvient pas :
(
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
)
Planifiez cette copie et envoyez-la hors du serveur. Posés sur le disque, les dumps entrent aussi dans les sauvegardes de nuit du serveur.
Sur la même installation ou sur une nouvelle, avec le même .env, arrêtez l'application, remplacez la base par une base vide, chargez-y le dump, puis redémarrez l'application :
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 arrête la restauration à la première erreur, au lieu de continuer et de signaler les erreurs à la fin, et les && arrêtent la séquence à cet endroit : Ryot reste arrêté. Ce qui a été chargé avant l'erreur reste dans la base : repartez donc de dropdb une fois la cause corrigée.Nous avons testé le cycle complet sur notre VPS avec ces commandes exactes : dump, base supprimée puis recréée vide, restauration. Les deux comptes, leurs collections et les 876 exercices sont revenus, et l'administrateur s'est reconnecté aussitôt.
Ryot exporte aussi vos propres données en JSON, depuis la page de réglages « Imports and Exports », et sait les réimporter. Cet export demande un stockage de fichiers compatible S3 ; le dump de la base ci-dessus fonctionne sans lui.
Ryot publie souvent, à un rythme à peu près hebdomadaire. Lisez les notes de version, faites une sauvegarde, changez l'étiquette de l'image dans le compose.yaml, puis tirez la nouvelle image et recréez le conteneur. Les migrations de la base se lancent seules au démarrage :
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop suit la branche principale : la documentation prévient qu'elle a souvent des bogues majeurs et peut perdre des données. Restez sur les versions publiées.Ryot collecte des données d'usage anonymes, des pages vues et quelques événements, sur une instance Umami auto-hébergée par son développeur. Pour la désactiver, ajoutez DISABLE_TELEMETRY=true à l'environnement du service ryot, puis lancez docker compose up -d.
L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS infogéré, nos équipes prennent le serveur en main et suivent votre instance de manière proactive ; Ryot reste votre logiciel, avec votre historique et vos réglages.
| Sujet | Nos équipes | Vous |
|---|---|---|
| Le serveur | Mises à jour du système et de la sécurité, interventions sur le serveur comprises | Le moment qui vous convient |
| La supervision | Serveur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appel | Votre historique, vos collections et vos intégrations dans Ryot |
| Ryot | Suivi proactif : erreurs, lenteurs, base de données et espace disque repérés, correction recommandée | Son installation, ses mises à jour, ses clés d'API et ses réglages, que vous appliquez, vous ou votre assistant IA |
| Les utilisateurs | Le serveur qui les porte, surveillé et sauvegardé | Les comptes, les inscriptions et l'authentification unique |
| Les sauvegardes | Chaque nuit, chiffrées et gardées hors de la machine ; restauration comprise | Les dumps de base et les exports JSON propres à Ryot, et la demande de restauration, quand vous en avez besoin |
| La migration | Votre serveur actuel migré, offert | Le moment de la bascule |
Si vous préférez que nos équipes interviennent dans l'application elle-même, cette prestation se facture à l'heure ou au forfait, avec un chiffrage communiqué avant l'intervention.
Avec un VPS infogéré Simafri, nos équipes tiennent à jour le serveur de votre instance Ryot, le surveillent jour et nuit et interviennent sans attendre votre appel ; elles suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez, vous ou votre assistant IA. Les sauvegardes sont chiffrées chaque nuit et gardées hors de la machine, leur restauration est comprise, et la migration de votre serveur actuel est offerte.
Oui. Ryot est sous licence GPL-3.0 : vous pouvez le faire tourner pour vous, votre famille ou votre équipe, sans licence à acheter. Ryot Pro est une clé payante facultative qui ajoute des fonctions à la même image. Reste le coût du serveur qui le fait tourner.
Placez l'image ignisda/ryot et PostgreSQL 18 dans un compose.yaml. Mettez le mot de passe de la base et SERVER_ADMIN_ACCESS_TOKEN dans un fichier .env, réglez FRONTEND_URL sur votre adresse en https, publiez le port 8000 sur 127.0.0.1, lancez docker compose up -d, et placez un proxy inverse en HTTPS devant.
Il n'y en a pas. Cliquez sur « Create a new account? » sur la page de connexion : le premier compte créé devient administrateur. Posez ensuite USERS_ALLOW_REGISTRATION=false pour fermer les inscriptions ; l'administrateur invite les autres utilisateurs depuis Settings, Users, avec un lien à usage unique.
Depuis la v9, les films et les séries demandent votre propre jeton TMDB : créez un compte TMDB gratuit, demandez une clé d'API, et placez son API Read Access Token dans MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Les jeux vidéo demandent une application Twitch, tandis que les livres fonctionnent sans aucune clé.
De peu. Sur notre VPS de test, une installation neuve occupait environ 240 à 300 Mo pour Ryot et 70 Mo pour PostgreSQL, et les deux images occupent environ 810 Mo de disque.
Exportez la base PostgreSQL avec docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot sous umask 077, pour que seul root puisse lire le dump, et gardez une copie de votre fichier .env. Pour restaurer, arrêtez l'application, recréez la base vide avec dropdb et createdb, puis chargez le dump avec pg_restore --exit-on-error --no-owner.
Lisez les notes de version et faites une sauvegarde, changez l'étiquette de l'image dans compose.yaml, puis lancez docker compose pull et docker compose up -d. Les migrations de la base se lancent seules au démarrage. Entre deux versions majeures, suivez la page de migration.
Un VPS infogéré couvre le serveur : système, sécurité, supervision et sauvegardes. Nos équipes suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez. Une intervention dans l'application se facture à l'heure ou au forfait.
Simafri
Parlons de votre projet
Dites-nous en deux mots ce qu'il vous faut : on revient vers vous rapidement.
Merci ! Votre demande a bien été envoyée. Nous vous répondrons rapidement.
Vous préférez l'email ? Écrivez-nous à support@simafri.com.