Seerr sur Google Cloud Run
Seerr est la fusion en 2026 de Jellyseerr et Overseerr — une interface utilisateur de requêtes open-source, sous licence MIT, qui se place devant un serveur multimédia Jellyfin, Plex ou Emby. Les utilisateurs parcourent et demandent des titres ; un administrateur approuve la demande, et Seerr appelle les API de Sonarr et Radarr pour déclencher l'acquisition. Ce module déploie Seerr sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure partagée de Google Cloud.
Ce guide se concentre sur les services cloud utilisés par Seerr et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.
Ce que coûte Seerr sur RAD, et comment cela se compare
L'exécution de Seerr dans votre propre projet GCP coûte environ 180,87 $/mois en frais Google Cloud ; les frais de module de RAD sont de 110 crédits uniques (ou 99 crédits dans un projet géré par RAD), couvrant la configuration et le support — pas la facture cloud continue, que Google vous facture directement dans votre propre projet ou que RAD facture à l'heure en crédits dans un projet géré par RAD. Si un coût d'exécution inférieur est plus important que la cible de déploiement, consultez le guide GKE pour l'option à moindre coût ; sinon, si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement lorsque vous ne l'utilisez pas — voir Mettre en pause gratuitement ci-dessous.
Ce que vous payez sur RAD
| Votre propre projet | Projet géré par RAD | |
|---|---|---|
| Frais de module | 110 crédits, une fois | 99 crédits, une fois (10 % de moins) |
| Builds | Inclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés pour le temps de build à la minute | Idem |
| Coût d'exécution Google Cloud | ~180,87 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google | ~113 crédits/jour, facturé à l'heure par RAD au prix catalogue plus marge |
Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).
Coût d'exécution par défaut dans votre propre projet
| Ressource | US$/mois (prix catalogue Google, us-central1) |
|---|---|
| Cloud Run, 2x vCPU / 4 GiB (alwaysOn) | 110,42 $ |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 $ |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ |
| Cloud NAT et réseau | 5,00 $ |
| Cloud Storage (modules complémentaires, sauvegardes) | 1,00 $ |
| Total | 180,87 $ |
Comment cela se compare
- L'exécuter vous-même sur un VPS nu reste l'option la moins chère en espèces -- Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go est également à 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) est à environ 49 $/mois -- plus le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que le Cloud SQL géré par RAD, Secret Manager et la surveillance couvrent pour vous -- mais le prix de RAD n'est jamais censé battre un VPS, seulement remplacer le temps d'administration qu'un VPS nécessite encore.
- Seerr se trouve devant un serveur multimédia domestique plutôt que l'internet public, il fonctionne donc en continu mais avec un faible trafic -- notez que ce module nécessite
alwaysOnde calcul pour maintenir l'acquisition déclenchée par les requêtes réactive, c'est pourquoi son propre coût d'exécution est plus élevé que la plupart des applications de ce lot.
Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer quand vous en avez besoin
C'est le titre pour un projet géré par RAD. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logique récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne détruit pas Cloud SQL, aucune VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.
Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.
La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter une mise à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
Ce qu'il faut : vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude/démo). Google affirme que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logique de Cloud Storage explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé l'application et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.
Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer
Dans votre propre projet (ou une fois que vous avez dépassé la fenêtre de restauration de 30 jours ci-dessus), l'alternative est de supprimer Seerr purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 110 crédits.
La suppression ne permet d'économiser de l'argent que si Seerr resterait inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution quotidien — par rapport au total du projet ci-dessus, cela représente environ 2 jours ou plus. La majeure partie du coût d'exécution ici est généralement la base de données et la VM NFS/cache ; elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de cette application pendant que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
Conserver les données en premier : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.
Sessions de lab et environnements gérés
- Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant dispose de l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
- Environnements gérés, pour les cabinets de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, afin que personne ne reçoive de frais inattendus. À la fin, le partenaire remet le projet et les déploiements deviennent la propriété du client.
- Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.
Sources (8 octobre 2026) : Prix catalogue de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; https://cloud.google.com/resource-manager/docs/delete-restore-projects pour les mécanismes de pause/restauration.
1. Vue d'ensemble
Seerr s'exécute comme un conteneur Node.js/Next.js unique sur Cloud Run v2. Le déploiement relie un petit ensemble de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Processus Node.js unique, 2 vCPU / 4 GiB par défaut |
| Base de données | Cloud SQL PostgreSQL 15 | Contient les données de requête/utilisateur ; les migrations s'exécutent automatiquement à chaque démarrage |
| Stockage d'objets | Cloud Storage | Un bucket storage monté à /app/config via GCS FUSE — contient settings.json, les propres paramètres d'application de Seerr |
| Cache et file d'attente | aucun | Seerr n'a pas de dépendance Redis ou de file d'attente |
| Secrets | Secret Manager | Seulement le mot de passe de base de données généré — Seerr ne fournit pas ses propres identifiants (son premier administrateur provient de l'assistant de configuration web de l'application) |
| Ingress | URL Cloud Run | URL run.app par défaut ; équilibreur de charge HTTPS externe optionnel + domaine personnalisé |
Valeurs par défaut judicieuses à connaître d'emblée :
- Véritablement pré-construit — pas d'image personnalisée. Le répertoire
Seerr_Commondescripts/est vide.container_image_source = "prebuilt"déploieghcr.io/seerr-team/seerrdirectement ; il n'y a pas d'étape Cloud Build pour l'image principale. DB_TYPE=postgresest défini inconditionnellement. La propre logique de source de données de Seerr (process.env.DB_TYPE === 'postgres', confirmée via/app/dist/datasource.jsdans l'image réelle) utilise un fichier SQLite intégré au conteneur — effacé à chaque redémarrage, sans erreur — si cette variable est manquante.Seerr_Commonla définit comme une variable d'environnement statique afin qu'un déploiement standard soit toujours correct.- Port 5055, chemin de santé
/api/v1/status. Confirmé via des testsdocker runlocaux et un déploiement en direct :GET /api/v1/statusrenvoie un200non authentifié avec JSON ({"version":...,"commitTag":...}) une fois l'application prête. - Deux éléments d'état distincts. PostgreSQL contient les données de
requête/utilisateur. Les propres paramètres d'application de Seerr (serveurs
multimédias connectés, curseurs de découverte, agents de notification) sont
écrits dans un fichier
settings.jsonsimple sous/app/configindépendamment du backend de la base de données — confirmé par inspection directe du système de fichiers du conteneur. Ce module monte un volume GCS persistant à ce chemin en plus de la connexion Postgres. DB_PASS, pasDB_PASSWORD. La source de données TypeORM de Seerr lit une variable d'environnementDB_PASSspécifiquement nommée pour le mot de passe de la base de données. Ce module définitdb_password_env_var_name = "DB_PASS"pour correspondre.
2. Services Google Cloud et comment les explorer
Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms des services et des ressources sont
indiqués dans les Sorties du déploiement.
A. Cloud Run — le service Seerr
- Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux et les métriques.
- CLI :
gcloud run services list --project "$PROJECT" --region "$REGION"
gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
Voir App_CloudRun pour la mise à l'échelle, la concurrence et la répartition du trafic.
B. Cloud SQL — données de requête/utilisateur
- CLI :
gcloud sql instances list --project "$PROJECT"
gcloud sql databases list --instance=<instance-name> --project "$PROJECT"
C. Cloud Storage — le volume des paramètres
Le bucket storage est monté à /app/config via GCS FUSE. Il contient
settings.json (et settings.old.json, un répertoire db/, et logs/) —
la configuration de niveau application de Seerr, distincte de tout ce qui est stocké dans
PostgreSQL.
- CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~seerr"
gcloud storage ls "gs://<bucket-name>/"
D. Secret Manager
Seul le mot de passe de base de données auto-généré réside ici — Seerr n'a pas de secret d'identifiant administrateur propre.
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~seerr"
E. Réseau et ingress
- CLI :
gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
F. Cloud Logging et Monitoring
- CLI :
gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50
3. Comportement de l'application Seerr
- Pas de job de schéma de base de données au premier déploiement. Le
dist/index.jsde Seerr appelledbConnection.runMigrations()explicitement à chaque démarrage, il n'y a donc pas de jobdb-init/migrate dans ce module et aucun n'est nécessaire.initialization_jobsest vide par défaut. - La configuration initiale se fait entièrement dans l'interface web de l'application. Il n'y a pas d'identifiant administrateur pré-rempli de quelque nature que ce soit — visitez l'URL du service après le premier déploiement et complétez l'assistant de configuration de Seerr : connectez Jellyfin/Plex/Emby, puis Sonarr/Radarr.
- Chemin de santé. Les sondes de démarrage et de vivacité ciblent toutes deux
GET /api/v1/status— un200non authentifié avec une charge utile JSON une fois que l'application a terminé son démarrage et sa connexion à Postgres. - Inspecter l'exécution des jobs (devrait ne rien afficher, par conception) :
gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"
⚠ Le piège DB_TYPE — la chose la plus importante à savoir sur ce module
La sélection de la source de données de Seerr est une vérification de variable
d'environnement unique, facile à manquer, confirmée en lisant /app/dist/datasource.js
à l'intérieur de l'image en cours d'exécution :
exports.isPgsql = process.env.DB_TYPE === 'postgres';
Si DB_TYPE n'est pas défini exactement sur postgres, Seerr
revient silencieusement à un fichier de base de données SQLite intégré au
conteneur — pas d'erreur, pas d'avertissement dans les journaux, et un
déploiement qui semble par ailleurs complètement sain (le conteneur démarre,
le contrôle de santé passe, l'interface utilisateur se charge). Chaque écriture
— y compris toute la configuration initiale — va dans un fichier effacé au
prochain redémarrage ou démarrage à froid.
Seerr_Common comble cette lacune avec une variable d'environnement statique
définie inconditionnellement avant tout environment_variables fourni par
l'appelant :
environment_variables = merge(
{ DB_TYPE = "postgres" },
var.environment_variables
)
Un déploiement standard de ce module est correct dès la sortie de la boîte. Le
risque ne se manifeste que si vous forkez le module Common ou remplacez
environment_variables entièrement au lieu d'ajouter des couches — vérifiez que
DB_TYPE=postgres survit à un tel changement avec :
gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION" \
--format='value(spec.template.spec.containers[0].env)' | grep DB_TYPE
4. Variables de configuration
Les variables sont regroupées exactement telles qu'elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour Seerr sont listés ; toute autre entrée est héritée de App_CloudRun avec son comportement standard.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | seerr | Nom de base pour les ressources. |
display_name | Seerr | Nom lisible par l'homme affiché dans l'interface utilisateur de la plateforme. |
application_version | latest | Tiré directement comme le tag d'image ghcr.io/seerr-team/seerr — aucune étape de build n'est impliquée. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
container_port | 5055 | Confirmé via docker run local et déploiement en direct. |
container_image_source | prebuilt | Seerr ne prend en charge que l'image officielle ; Seerr_Common la code également en dur en interne. |
min_instance_count / max_instance_count | 1 / 5 | Voir §6 ci-dessous — max_instance_count = 5 est une valeur par défaut plus souple que ce que le modèle de paramètres à écrivain unique de Seerr suggérerait. |
enable_image_mirroring | true | Met en miroir l'image dans Artifact Registry (évite les limites de débit de GHCR). |
Groupe 11 — Stockage et système de fichiers
| Variable | Valeur par défaut | Description |
|---|---|---|
storage_buckets | un bucket data | Bucket supplémentaire, séparé du bucket storage automatique. |
gcs_volumes | [] | Le montage du bucket storage à /app/config est ajouté automatiquement ; utilisez ceci uniquement pour des volumes supplémentaires. |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Requis — Seerr n'a pas de chemin non-Postgres. |
db_name / db_user | seerr / seerr | Transmis à Seerr_Common, injecté comme DB_NAME/DB_USER. |
db_password_env_var_name | DB_PASS | Critique — la source de données de Seerr lit spécifiquement DB_PASS, pas le DB_PASSWORD par défaut de la Fondation. |
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Vide et reste généralement ainsi — dbConnection.runMigrations() s'exécute à chaque démarrage à l'intérieur de l'application elle-même. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe / liveness_probe | HTTP /api/v1/status (via Seerr_Common) | Point de terminaison de statut JSON 200 non authentifié ; la valeur par défaut variables.tf de la variante (HTTP /) est remplacée par la valeur par défaut plus précise de Seerr_Common. |
5. Sorties
| Sortie | Description |
|---|---|
service_name / service_url | Nom et URL du service Cloud Run. |
database_instance_name / database_name / database_user / database_password_secret | Identifiants de l'instance Cloud SQL et de la base de données Seerr. |
storage_buckets | Le bucket storage qui soutient /app/config. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
initialization_jobs | Noms des jobs d'initialisation créés (vide pour Seerr). |
6. Pièges de configuration et valeurs par défaut judicieuses
Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).
| Paramètre | Valeur judicieuse | Risque | Conséquence si erroné |
|---|---|---|---|
Variable d'environnement DB_TYPE | Laisser la valeur par défaut de Seerr_Common (postgres) inchangée | Critique | Un DB_TYPE manquant/écrasé fait tomber Seerr silencieusement sur un fichier SQLite par conteneur effacé à chaque redémarrage — l'application semble saine, mais rien ne persiste. |
db_password_env_var_name | Laisser à DB_PASS | Critique | La source de données TypeORM de Seerr ne lit que DB_PASS ; le DB_PASSWORD par défaut de la Fondation n'est jamais lu, et l'application ne peut pas s'authentifier auprès de Postgres. |
max_instance_count | Définir 1 si les changements de paramètres (configuration du serveur multimédia, curseurs de découverte, agents de notification) ne doivent jamais entrer en conflit | Moyen | settings.json est un fichier unique mutable, pas une base de données transactionnelle — des écrivains concurrents de plusieurs instances risquent une écriture perdue. La valeur par défaut du module est 5, plus souple que la valeur sécurisée pour un seul écrivain. |
gcs_volumes / stockage à /app/config | Laisser le montage storage automatique en place | Critique | La suppression ou la mauvaise configuration de ce volume entraîne la perte de tous les paramètres au niveau de l'application (serveurs multimédias, curseurs, agents de notification) au prochain démarrage à froid, même si les données Postgres sont intactes. |
| Chemin de la sonde | Laisser à /api/v1/status | Élevé | Un chemin de sonde authentifié ou inexistant laisserait la révision en permanence non saine même si l'application a démarré correctement. |
Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à Seerr partagée avec la variante GKE est décrite dans Seerr_Common.
Guides associés
- Lab pratique : Seerr sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Seerr sur GKE Autopilot — la même application sur Kubernetes, lorsque vous avez besoin de l'autre cible de déploiement.
- Seerr Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.