Logo

Configuration avancée

Ajouter vos propres conteneurs à YAMS

Appropriez-vous YAMS 🚀

Vous souhaitez ajouter d’autres services à votre installation YAMS ? Peut-être une nouvelle application sympa que vous avez trouvée, ou quelque chose de spécifique à vos besoins ? Pas de problème ! YAMS permet d’étendre facilement votre serveur multimédia avec des conteneurs personnalisés.

Les bases 📚

Lors de son installation, YAMS créé deux fichiers importants :

  • docker-compose.yaml: C’est le cœur de YAMS ! Il ne faut pas modifier directement ce fichier.
  • docker-compose.custom.yaml: C’est votre terrain de jeu ! Vous pouvez ajoutez vos conteneurs ici.

Démarrage 🎯

Tout d’abord, trouvons votre installation YAMS. Je vais utiliser /opt/yams dans ces exemples, mais remplacez-le par l’emplacement d’installation que vous avez choisi :

cd /opt/yams

Les variables magiques ✨

YAMS fournit quelques variables d’environnement pratiques que vous pouvez utiliser dans vos conteneurs personnalisés :

PUID: Votre ID d'utilisateur
PGID: Votre ID de groupe
MEDIA_DIRECTORY: Emplacement du répertoire multimédia
INSTALL_DIRECTORY: Emplacement d'installation de YAMS

Ces varaiables permettent à vos conteneurs personnalisés de fonctionner facilement avec YAMS !

Ajout d’un conteneur ! 🎮

Prenons comme exemple Overseerr, une fantastique application de gestion de requêtes pour votre serveur multimédia.

  1. Ouvrez d’abord docker-compose.custom.yaml:
nano docker-compose.custom.yaml
  1. S’il s’agit de votre premier conteneur personnalisé, vous devrez d’abord décommenter la ligne services:. Votre fichier devrait commencer ainsi :
services: # Assurez-vous que la ligne est bien décommentée !
  1. Ajoutons maintenant Overseerr en utilisant toutes les fonctionnalités de YAMS :
overseerr:
    image: lscr.io/linuxserver/overseerr:latest
    container_name: overseerr
    environment:
        - PUID=${PUID} # Variable ID utilisateur de YAMS
        - PGID=${PGID} # Variable ID de groupe de YAMS
    volumes:
        - ${INSTALL_DIRECTORY}/config/overseer:/config # On utilise le dossier de configuration fourni par Yams
    ports:
        - 5055:5055
    restart: unless-stopped
  1. Il est temps de démarrer votre nouveau conteneur :
yams restart

Vous devriez voir quelque chose similaire à ça :

 ⠙ overseerr Pulling                                                                     5.2s
[...]

C’est tout bon ! Votre nouveau service est installé et lancé ! 🎉

Astuces 🎓

1. Découvrir de nouveaux services

Vous cherchez des services cools à ajouter à YAMS ? Jetez un coup d’œil à ceux-ci :

2. Réseau magique 🌐

Tous les conteneurs dans votre docker-compose.custom.yaml rejoignent automatiquement le réseau de YAMS ! Ça permet à l’ensemble des services de communiquer entre eux en utilisant le noms de leurs conteneurs en tant que noms d’hôtes.

Par exemple, si vous avez besoin de connecter Radarr à un conteneur personnalisé, vous pouvez utiliser http://radarr:7878 en tant qu’URL.

3. Accès VPN 🔒

Vous souhaitez que votre conteneur personnalisé utilise le VPN de YAMS ? Il suffit d’ajouter ceci à la configuration de ce dernier :

network_mode: "service:gluetun"

Consultez le guide Lancer Prowlarr derrière le VPN pour voir un exemple détaillé !

4. La force des variables 💪

Vous pouvez accéder à n’importe quelle variable depuis le fichier .env de YAMS pour les utiliser dans vos conteneurs personnalisés. Il suffit d’utiliser la syntaxe ${NOM_DE_LA_VARIABLE} !

Problèmes courants 🚨

  1. Nom des conteneurs : Assurez-vous que le nom de vos conteneurs n’entre pas en conflit avec ceux de YAMS.
  2. Conflit de ports : Vérifiez bien que vos nouveaux conteneurs n’essayent pas d’accéder à des ports déjà utilisés.
  3. Permissions : Si votre conteneur à besoin d’accéder aux fichiers multimédias, pensez à utiliser PUID et PGID!

Besoin d’idées ? 💡

Voici quelques services populaires qui fonctionnent bien avec YAMS :

  1. Overseerr ou Petio : Permet aux utilisateurs de demander des films et séries
  2. Tautulli : Gestion et statistiques avancées pour Plex
  3. Organizr : Créé une interface élégante pour tous vos services

Besoin d’aide ? 🆘

Si vous avez rencontré un problème :

  1. Visitez notre page Problèmes courants
  2. Visitez le Forum YAMS
  3. Rejoignez notre serveur Discord ou Matrix

N’oubliez pas : L’objectif de YAMS est de créer VOTRE serveur multimédia personnalisé. N’hésitez pas à expérimenter et à le personnaliser à votre guise ! 😎