141 lines
5.6 KiB
Markdown
141 lines
5.6 KiB
Markdown
---
|
|
title: "Ajouter vos propres conteneurs à YAMS"
|
|
date: 2025-01-15T11:50:16+02:00
|
|
draft: false
|
|
weight: 1
|
|
summary: Un guide complet pour enrichir YAMS avec vos propres conteneurs Docker
|
|
---
|
|
|
|
# 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 :
|
|
|
|
```bash
|
|
cd /opt/yams
|
|
```
|
|
|
|
## Les variables magiques ✨
|
|
|
|
YAMS fournit quelques variables d'environnement pratiques que vous pouvez utiliser dans vos conteneurs personnalisés :
|
|
|
|
```yaml
|
|
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](https://overseerr.dev/), une fantastique application de gestion de requêtes pour votre serveur multimédia.
|
|
|
|
1. Ouvrez d'abord `docker-compose.custom.yaml`:
|
|
|
|
```bash
|
|
nano docker-compose.custom.yaml
|
|
```
|
|
|
|
2. S'il s'agit de votre premier conteneur personnalisé, vous devrez d'abord décommenter la ligne `services:`. Pour décommenter, vous devez supprimer le symbole `#` et l'espace qui suit. Votre fichier devrait commencer comme suit :
|
|
|
|
```yaml
|
|
services: # Assurez-vous que la ligne est bien décommentée et qu'il n'y a pas d'espaces avant !
|
|
```
|
|
|
|
3. Ajoutons maintenant Overseerr en utilisant toutes les fonctionnalités de YAMS :
|
|
|
|
```yaml
|
|
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
|
|
```
|
|
|
|
4. Il est temps de démarrer votre nouveau conteneur :
|
|
|
|
```bash
|
|
yams restart
|
|
```
|
|
|
|
Vous devriez voir quelque chose similaire à ça :
|
|
|
|
```bash
|
|
⠙ 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 :
|
|
|
|
- [linuxserver.io fleet](https://fleet.linuxserver.io/) (fortement recommandé)
|
|
- [Docker Hub](https://hub.docker.com/)
|
|
|
|
### 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 :
|
|
|
|
```yaml
|
|
network_mode: "service:gluetun"
|
|
```
|
|
|
|
Consultez le guide [Lancer Prowlarr derrière le VPN](/advanced/prowlarr-behind-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. **Erreurs de formatage YAML** : YAML est très sensible à l'espacement et à l'indentation. Même un simple espace mal placé peut casser votre configuration ! Nous recommandons fortement l'utilisation d'un validateur YAML comme [yamllint.com](https://www.yamllint.com/) pour vérifier votre syntaxe avant d'appliquer les changements.
|
|
2. **Nom des conteneurs** : Assurez-vous que le nom de vos conteneurs n'entre pas en conflit avec ceux de YAMS.
|
|
3. **Conflit de ports** : Vérifiez bien que vos nouveaux conteneurs n'essayent pas d'accéder à des ports déjà utilisés.
|
|
4. **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](https://overseerr.dev/)** ou **[Petio](https://petio.tv/)** : Permet aux utilisateurs de demander des films et séries
|
|
2. **[Tautulli](https://tautulli.com/)** : Gestion et statistiques avancées pour Plex
|
|
3. **[Organizr](https://organizr.app/)** : 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](/faqs/common-errors/)
|
|
2. Visitez le [Forum YAMS](https://forum.yams.media)
|
|
3. Rejoignez notre serveur [Discord](https://discord.gg/Gwae3tNMST) ou [Matrix](https://matrix.to/#/#yams-space:rogs.me)
|
|
|
|
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 ! 😎
|