Héberger Ryot sur un VPS infogéré : votre suivi des médias et du sport

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.

Simon Vasconcelos Lee Par Publié le 19 novembre 2026Lecture : 11 minutes

Tous les guides

L'essentiel

  1. La licence GPL-3.0 permet de faire tourner Ryot pour vous, votre famille ou votre club, sans licence à acheter ; Ryot Pro, une clé payante, ajoute des fonctions à la même image.
  2. Installez-le avec Docker Compose : l'image ignisda/ryot et PostgreSQL 18, avec le port 8000 publié sur 127.0.0.1 derrière un proxy inverse en HTTPS.
  3. Placez le mot de passe de la base et SERVER_ADMIN_ACCESS_TOKEN dans un fichier .env, et réglez FRONTEND_URL sur votre adresse publique.
  4. Le premier compte que vous créez devient administrateur ; posez ensuite USERS_ALLOW_REGISTRATION=false pour fermer les inscriptions d'une instance privée.
  5. Les livres fonctionnent aussitôt ; les films et les séries demandent un jeton TMDB, les jeux vidéo une application Twitch. Sauvegardez avec pg_dump, puis mettez à jour en changeant l'étiquette de l'image.

Ce que fait Ryot

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.

Ce que permet la licence GPL-3.0

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.

Les ressources à prévoir

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.

L'installation avec Docker Compose

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 :

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:

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 :

Terminal, dans /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

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 :

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

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.

HTTPS : le proxy inverse

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.

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

Le premier compte, les inscriptions et les invitations

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 :

  1. Ouvrez votre adresse : Ryot affiche sa page de connexion.
  2. Cliquez sur « Create a new account? », puis saisissez un nom d'utilisateur et, deux fois, un mot de passe.
  3. Inscrivez-vous, puis connectez-vous avec vos nouveaux identifiants : vous arrivez sur le tableau de bord, avec une visite guidée.
  4. Dans « Settings », « Users », votre compte apparaît avec le rôle Admin.

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 ».

Inviter les autres utilisateurs

  1. Dans « Settings », « Users », cliquez sur le bouton + à côté du titre.
  2. Saisissez le nom d'utilisateur de la personne : Ryot crée le compte et affiche un lien à usage unique.
  3. Envoyez le lien : la personne l'ouvre, choisit un mot de passe, puis se connecte.

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.

Films, séries et jeux : les clés d'API

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édiaFournisseurCe qu'il faut renseigner
LivresOpen LibraryRien : il fonctionne aussitôt. Google Books et Hardcover sont facultatifs, avec leur clé d'API
Films et sériesTMDB, ou TVDBMOVIES_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éoIGDB, par TwitchVIDEO_GAMES_TWITCH_CLIENT_ID et VIDEO_GAMES_TWITCH_CLIENT_SECRET, tirés d'une application de la console développeur de Twitch
MusiqueSpotify, facultatifMUSIC_SPOTIFY_CLIENT_ID et MUSIC_SPOTIFY_CLIENT_SECRET
Import d'animeMyAnimeListANIME_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.

Les sauvegardes

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 :

Terminal, dans /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
)

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.

Restaurer

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 :

Terminal, dans /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

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.

Les mises à jour

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 :

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

La télémétrie

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.

Qui fait quoi sur un VPS infogéré

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.

SujetNos équipesVous
Le serveurMises à jour du système et de la sécurité, interventions sur le serveur comprisesLe moment qui vous convient
La supervisionServeur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appelVotre historique, vos collections et vos intégrations dans Ryot
RyotSuivi proactif : erreurs, lenteurs, base de données et espace disque repérés, correction recommandéeSon installation, ses mises à jour, ses clés d'API et ses réglages, que vous appliquez, vous ou votre assistant IA
Les utilisateursLe serveur qui les porte, surveillé et sauvegardéLes comptes, les inscriptions et l'authentification unique
Les sauvegardesChaque nuit, chiffrées et gardées hors de la machine ; restauration compriseLes dumps de base et les exports JSON propres à Ryot, et la demande de restauration, quand vous en avez besoin
La migrationVotre serveur actuel migré, offertLe 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.

Ryot, sur un serveur tenu pour vous

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.

Découvrir les VPS infogérés

Questions fréquentes

Ryot est-il gratuit ?

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.

Comment installer Ryot avec Docker Compose ?

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.

Quels sont les identifiants par défaut de Ryot ?

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.

Pourquoi Ryot ne trouve-t-il ni films ni séries ?

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 combien de mémoire Ryot a-t-il besoin ?

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.

Comment sauvegarder Ryot ?

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.

Comment mettre à jour Ryot ?

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-t-il Ryot ?

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.

Guides liés

Héberger PostgreSQL sur un VPS : dimensionner mémoire et disqueUne base PostgreSQL rapide est une base dont les données consultées souvent tiennent en mémoire. Tout le dimensionnement part de là : le volume de la base, la part qui travaille vraiment, le nombre de connexions, puis le disque et sa marge. Ce guide donne la méthode, les réglages de départ pour 4, 8 et 16 Go de mémoire, et les requêtes qui mesurent une base existante.Sauvegardes d'un VPS : ce qu'il faut vérifier avant de signerUne offre de VPS annonce presque toujours « sauvegardes comprises ». Derrière ces deux mots, il peut y avoir une copie chaque nuit, gardée hors de la machine et restaurée par des experts, ou un instantané posé sur le même disque que le serveur. Ce guide donne les questions qui font la différence, ce que chaque réponse veut dire, et la façon de vérifier qu'une sauvegarde se restaure.Héberger Actual Budget sur un VPS infogéré : vos budgets sur votre serveurHéberger Actual Budget sur un VPS infogéré, c'est garder vos budgets et leur synchronisation sur une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Actual Budget est un outil de finances personnelles local-first, publié sous licence MIT. Ce guide suit sa documentation officielle : le rôle du serveur, l'installation avec Docker Compose, HTTPS, le mot de passe du serveur, OpenID, le chiffrement de bout en bout, la synchronisation bancaire, les sauvegardes et les mises à jour.
Contactez-nous