Seerr sur GKE Autopilot
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 requête, et Seerr appelle les API de Sonarr et Radarr pour déclencher l'acquisition. Ce module déploie Seerr sur GKE Autopilot au-dessus de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.
Ce guide se concentre sur les services cloud que Seerr utilise et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — veuillez vous référer au guide de la fondation App_GKE 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 149,81 $/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 mesure à l'heure en crédits dans un projet géré par RAD. Ou consultez le guide Cloud Run pour la cible de déploiement alternative ; dans tous les cas, 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 Mettez-le 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 à la minute pour le temps de build | Idem |
| Coût d'exécution Google Cloud | ~149,81 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google | ~141 crédits/jour, mesuré à l'heure par RAD au prix catalogue plus marge |
Pourquoi les deux colonnes diffèrent. Le chiffre du projet géré par RAD inclut les frais de gestion du cluster GKE (environ 73 US$ par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du propre projet suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore assez d'historique GKE géré par RAD pour le mesurer, de sorte que la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.
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) |
|---|---|
| Pod GKE Autopilot, 2x vCPU / 4 Gio | 79,35 $ |
| 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 $ |
| Frais de gestion du cluster GKE | partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $ |
| Total | 149,81 $ |
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 coûte également 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) coûte environ 49 $/mois — plus le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que Cloud SQL, Secret Manager et la surveillance gérés par RAD couvrent pour vous — mais le prix de RAD n'est jamais destiné à 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.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le 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 logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL, aucune VM ni 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 niveau (100 crédits pour le niveau sandbox qui convient à la plupart des utilisations d'étude/démo). Google affirme que la plupart des services sont à nouveau pleinement opérationnels 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 logicielle 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.
Payez uniquement pendant que vous l'utilisez, 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 reste 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 alors que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
Conservez 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 obtient 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 sociétés 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 transfère 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 seul pod Node.js/Next.js. Le déploiement relie un petit ensemble de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pod de processus Node.js unique, 2 vCPU / 4 Gio 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 de pod |
| Stockage d'objets | Cloud Storage | Un bucket storage monté à /app/config via GCS FUSE (ou un PVC StatefulSet facultatif) — contient settings.json, les propres paramètres de l'application 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 la base de données généré — le premier administrateur de Seerr provient de l'assistant de configuration web de l'application |
| Ingress | Cloud Load Balancing | LoadBalancer externe, domaine personnalisé facultatif + certificat géré |
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. DB_TYPE=postgresest défini inconditionnellement parSeerr_Common— voir le §3 du guide Cloud Run pour l'explication complète ; le même piège et la même correction s'appliquent ici.- Port 5055, chemin de santé
/api/v1/status. Confirmé via des tests locauxdocker runet un déploiement en direct (le pod a signalé3/3 Running,GET /api/v1/statusa renvoyé du JSON réel viakubectl exec). - Un bug de permission GCS-FUSE spécifique à GKE, trouvé et corrigé. Le
conteneur de Seerr s'exécute en tant que
uid=1000/gid=1000. L'intégration gcsfuse de Cloud Run applique automatiquement cet UID/GID au montage ; le pilote CSI GKE GCS FUSE ne le fait pas — sans correction explicite, le pod boucle en cas de crash au premier démarrage avecEACCES: permission denieden essayant de créer/app/config/logs/.Seerr_Commonmonte le volume avecuid=1000,gid=1000,file-mode=0664,dir-mode=0775pour corriger cela. Voir §3. - Deux éléments d'état distincts. PostgreSQL contient les données de
requête/utilisateur. Les propres paramètres de l'application Seerr (serveurs
multimédias connectés, curseurs de découverte, agents de notification) vivent
dans un simple fichier
settings.jsonsous/app/config— quel que soit le backend de la base de données. DB_PASS, pasDB_PASSWORD. La source de données TypeORM de Seerr lit une variable d'environnementDB_PASSnommée spécifiquement. 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 vous avez exécuté
gcloud container clusters get-credentials <cluster> --region <region> --project <project>
et que PROJECT, REGION et NAMESPACE sont définis.
A. GKE Autopilot — la charge de travail Seerr
- CLI :
kubectl get pods,svc -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
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. Stockage — Cloud Storage ou un PVC de bloc
- CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~seerr"
kubectl get pvc -n "$NAMESPACE" # only when stateful_pvc_enabled = true
D. Secret Manager
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~seerr"
E. Réseau et ingress
- CLI :
kubectl get svc -n "$NAMESPACE" -o wide
F. Cloud Logging et Monitoring
- CLI :
kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100 -f
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 de pod, il n'y a donc pas de job d'initialisation 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 aucune information d'identification d'administrateur pré-remplie — connectez-vous au service et complétez l'assistant de configuration de Seerr : serveur multimédia d'abord, puis Sonarr/Radarr.
- Chemin de santé. Les sondes de démarrage et de vivacité ciblent toutes
deux
GET /api/v1/status. - Inspecter l'exécution du job (ne devrait rien afficher, par conception) :
kubectl get jobs -n "$NAMESPACE"
⚠ Le bug UID/GID de GCS-FUSE — le piège spécifique à GKE que ce module corrige
Le conteneur de Seerr s'exécute en tant que uid=1000/gid=1000 (l'utilisateur
node — confirmé via docker run ghcr.io/seerr-team/seerr id), et au premier démarrage
tente mkdir '/app/config/logs/'.
- Sur Cloud Run, l'intégration gcsfuse de la plateforme applique
automatiquement
uid:1000/gid:1000au volume monté, cela fonctionne donc sans configuration supplémentaire. - Sur GKE, le pilote CSI GCS FUSE ne définit pas par défaut un UID
inscriptible. Un montage
gcs_volumesnu est détenu par root, et le conteneur non-root boucle en cas de crash avecEACCES: permission denied.
Seerr_Common corrige cela en définissant des mount_options explicites sur le
volume de stockage qu'il déclare pour /app/config :
mount_options = [
"implicit-dirs", "stat-cache-ttl=60s", "type-cache-ttl=60s",
"uid=1000", "gid=1000", "file-mode=0664", "dir-mode=0775",
]
Il s'agit d'une classe de bugs connue dans ce catalogue — la même forme de
défaillance a été précédemment trouvée et corrigée sur les variantes GKE de
Paperless, CodeServer et CloudBeaver (voir la découverte "GKE gcsfuse UID/GID
permission denied" du dépôt CLAUDE.md). Seerr est la dernière instance
confirmée, maintenant corrigée au niveau Seerr_Common afin que les deux
modules d'application héritent de la correction uniformément.
Indicateur de diagnostic, si vous rencontrez ce symptôme sur un fork de ce module :
kubectl describe pod -n "$NAMESPACE" <seerr-pod>
# Look for: EACCES: permission denied, mkdir '/app/config/logs/'
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_GKE avec son comportement standard.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | seerr | Nom de base des ressources. |
application_display_name | Seerr | Nom lisible par l'homme affiché dans l'interface utilisateur de la plateforme. |
application_version | latest | Tiré directement comme étiquette 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 ; le service K8s et les sondes doivent tous être d'accord sur cette valeur. |
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. |
Groupe 31 — Configuration du StatefulSet
| Variable | Valeur par défaut | Description |
|---|---|---|
stateful_pvc_enabled | false | settings.json est un petit état JSON de fichier entier — sûr sur un volume GCS FUSE à max_instance_count = 1, donc un PVC de bloc est facultatif ici, contrairement aux applications SQLite en mode WAL de ce catalogue. |
stateful_pvc_mount_path | /app/config | Correspond au chemin de montage par défaut de GCS FUSE. |
stateful_pvc_storage_class | standard | HDD pd-standard — settings.json n'a pas besoin de IOPS élevées. |
Groupe 16 — Base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Requis — Seerr n'a pas de chemin non-Postgres. |
application_database_name / application_database_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, et non le DB_PASSWORD par défaut de la Fondation. |
Groupe 11 — Automatisation de la charge de travail
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Vide et reste généralement ainsi — dbConnection.runMigrations() s'exécute à chaque démarrage de pod au sein de l'application elle-même. |
Groupe 14 — Cloud Storage
| Variable | Valeur par défaut | Description |
|---|---|---|
gcs_volumes | [] | Le montage du bucket storage avec correction de permissions à /app/config est ajouté automatiquement (voir §3) ; utilisez ceci uniquement pour des volumes supplémentaires. |
Groupe 10 — 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 / service_external_ip | Identité et adresse du service Kubernetes. |
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 supportant /app/config (inutilisé comme montage si stateful_pvc_enabled = true). |
kubernetes_ready | Indique si la charge de travail a atteint l'état Prêt. |
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 | Laissez la valeur par défaut de Seerr_Common (postgres) intacte | Critique | DB_TYPE manquant/écrasé place silencieusement Seerr sur un fichier SQLite par pod effacé à chaque redémarrage. |
GCS FUSE mount_options sur /app/config | Laissez la correction uid=1000/gid=1000 de Seerr_Common en place | Critique | Sans cela, le pod boucle en cas de crash avec EACCES: permission denied au premier démarrage — un mode de défaillance spécifique à GKE non observé sur Cloud Run. |
db_password_env_var_name | Laissez à 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 seul. |
max_instance_count | Définissez 1 si les changements de paramètres ne doivent jamais être en concurrence | Moyen | settings.json est un fichier unique et mutable — des écritures concurrentes de plusieurs pods risquent une perte d'écriture. La valeur par défaut du module est 5, plus lâche que la valeur sûre pour un seul rédacteur. |
stateful_pvc_enabled | Laissez false à moins d'avoir une raison spécifique pour le stockage par blocs | Faible | settings.json n'a pas besoin de verrouillage de fichier POSIX comme le ferait une application SQLite en mode WAL ; GCS FUSE est une valeur par défaut appropriée ici, contrairement aux applications qui nécessitent réellement un véritable périphérique de bloc. |
Pour le comportement de la fondation référencé tout au long — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à Seerr partagée avec la variante Cloud Run est décrite dans Seerr_Common.
Guides associés
- Lab pratique : Seerr sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Seerr sur Google Cloud Run — la même application sur Cloud Run, 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.
- Déployé aux côtés de Jellyfin sur GKE Autopilot, Prowlarr sur GKE Autopilot, Jellystat sur GKE Autopilot, Homepage sur GKE Autopilot dans la solution Serveur multimédia.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.