From f20aa54586935ef78f5a5b773ac7c0114808ef9f Mon Sep 17 00:00:00 2001 From: Loriage <11054169-Loriage@users.noreply.gitlab.com> Date: Mon, 24 Mar 2025 11:28:02 +0100 Subject: [PATCH] Plex path, yaml errors & install steps --- content/advanced/add-your-own-containers.md | 11 ++-- content/config/plex.md | 2 + content/install/steps.md | 59 +++++++++++---------- 3 files changed, 38 insertions(+), 34 deletions(-) diff --git a/content/advanced/add-your-own-containers.md b/content/advanced/add-your-own-containers.md index c053be5..1d7762d 100644 --- a/content/advanced/add-your-own-containers.md +++ b/content/advanced/add-your-own-containers.md @@ -48,10 +48,10 @@ Prenons comme exemple [Overseerr](https://overseerr.dev/), une fantastique appli nano docker-compose.custom.yaml ``` -2. S'il s'agit de votre premier conteneur personnalisé, vous devrez d'abord décommenter la ligne `services:`. Votre fichier devrait commencer ainsi : +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 ! +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 : @@ -116,9 +116,10 @@ Vous pouvez accéder à n'importe quelle variable depuis le fichier `.env` de YA ## 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`! +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 ? 💡 diff --git a/content/config/plex.md b/content/config/plex.md index 627813b..3b1419f 100644 --- a/content/config/plex.md +++ b/content/config/plex.md @@ -78,6 +78,8 @@ Cela signifie que votre fichier `Preferences.xml` a besoin d'être corrigé : v Dans votre navigateur, allez à [http://{votre-adresse-ip}:32400/web]() et vous verrez la page d'installation de Plex. Cliquez sur "Got it!" pour commencer. +**Important :** Contrairement à d'autres services YAMS, Plex nécessite le chemin « /web » après son port. Si vous allez simplement sur le port 32400 sans « /web », vous verrez un fichier XML au lieu de l'interface web. + [![plex-1](/pics/plex-1.png)](/pics/plex-1.png) Après vous être connecté, vous verrez une fenêtre de dialogue "Plex Pass". Vous pouvez la fermer pour l'instant, nous allons passer aux choses sérieuses ! diff --git a/content/install/steps.md b/content/install/steps.md index 7c098b3..a256399 100644 --- a/content/install/steps.md +++ b/content/install/steps.md @@ -28,42 +28,43 @@ Ne vous inquiétez pas si vous n'avez pas encore installé `docker` et `docker c Avant d'entrer dans le vif du sujet, assurez-vous d'avoir : -### Un emplacement d'installation +- **Git installé :** Vous en aurez besoin pour cloner le dépôt YAMS. Vérifiez s'il est installé avec : + ```bash + git --version + ``` + Si vous ne l'avez pas encore, vous pouvez l'installer facilement : + ```bash + # Pour Debian/Ubuntu + sudo apt update + sudo apt install git + ``` -Le script utilise par défaut `/opt/yams` mais vous pouvez changer cet emplacement tant que votre utilisateur possède bien les permissions d'écriture. Si vous souhaitez utiliser l'emplacement par défaut (recommandé), configurez-le comme suit : +- **Un emplacement d'installation :** Le script utilise par défaut `/opt/yams` mais c'est à vous de choisir ! Assurez-vous simplement que votre utilisateur ait les permissions d'écriture à cet endroit. + +- **Un dossier multimédia :** C'est ici que tout votre contenu sera placé. Par exemple, si vous choisissez `/srv/media`, le script créera : + + `/srv/media/tv`: Pour vos séries + + `/srv/media/movies`: Pour vos films + + `/srv/media/music`: Pour votre bibliothèque musicale + + `/srv/media/books`: Pour votre bibiliothèque e-book + + `/srv/media/downloads`: Pour vos téléchargements + + `/srv/media/blackhole`: Pour votre dossier "trou noir" pour vos torrents + +- **Un utilisateur standard pour exécuter YAMS :** N'utilisez pas `root` (Vraiment ! 😅) + +- **Un VPN (optionnel mais FORTEMENT recommandé) :** Choisissez-en un parmi [cette liste](/advanced/vpn#fournisseurs-vpn-supportés-). Je recommande toujours [ProtonVPN](https://protonvpn.com/) car il est super simple à mettre en place ! + +## Étapes d'installation + +### 1. Définir l'emplacement d'installation + +L'emplacement `/opt/yams` est **recommandé**, mais vous pouvez être un rebelle et utiliser celui que vous voulez si votre utilisateur a les permissions : ```bash sudo mkdir -p /opt/yams sudo chown -R $USER:$USER /opt/yams ``` -### Un dossier multimédia - -C'est ici que tout votre contenu sera placé. Par exemple, si vous choisissez `/srv/media`, le script créera : - -- `/srv/media/tvshows`: Pour vos séries -- `/srv/media/movies`: Pour vos films -- `/srv/media/music`: Pour votre bibliothèque musicale -- `/srv/media/books`: Pour votre bibiliothèque e-book -- `/srv/media/downloads`: Pour vos téléchargements -- `/srv/media/blackhole`: Pour votre dossier "trou noir" pour vos torrents - -### Un utilisateur standard pour exécuter YAMS - -- Ne pas être `root` (Vraiment ! 😅) -- Cet utilisateur aura les permissions sur les fichiers multimédias -- Doit avoir les privilèges sudo pour l'installation initiale - -### Un VPN (optionnel mais FORTEMENT recommandé) - -- Chosissez-en un parmi [cette liste](/advanced/vpn#fournisseurs-vpn-supportés-) -- Nous recommendons ProtonVPN car : - - Simple à configurer - - Supporte nativement la redirection de port - - Axé sur la vie privée - - Tarifs abordables - -### Si Docker est déjà installé… +### 2. Si Docker est déjà installé… Assurez-vous de pouvoir lancer `docker` **sans** `sudo` ! Essayez cette commande :