From 3c85fec634eaad246d988e9548620b7da95164e2 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 12:59:34 +0200 Subject: [PATCH 01/20] Fix config and variable mismatches found in the audit --- content/en/2.general/2.networking/3.samba.md | 8 ++++---- content/en/3.serveex/2.core/2.docker.md | 12 ++++++++++-- content/en/3.serveex/2.core/3.wireguard.md | 11 +++++------ content/en/3.serveex/2.core/4.swag.md | 2 +- content/en/3.serveex/3.security/2.cloudflare.md | 15 +++++++++++++-- content/en/3.serveex/3.security/3.tinyauth.md | 4 ++-- content/en/3.serveex/3.security/4.pocket-id.md | 4 ++-- content/en/3.serveex/4.monitoring/5.upsnap.md | 2 +- content/en/3.serveex/5.media/3.servarr.md | 4 ++-- content/en/3.serveex/9.apps/1.adguard.md | 10 ++++++++-- content/en/3.serveex/91.advanced/1.authentik.md | 4 ++-- .../3.alternatives/3.servarr for plex.md | 4 ++-- content/fr/2.general/2.networking/3.samba.md | 10 +++++----- content/fr/3.serveex/2.core/2.docker.md | 12 ++++++++++-- content/fr/3.serveex/2.core/3.wireguard.md | 11 +++++------ content/fr/3.serveex/2.core/4.swag.md | 2 +- content/fr/3.serveex/3.security/2.cloudflare.md | 15 +++++++++++++-- content/fr/3.serveex/3.security/3.tinyauth.md | 4 ++-- content/fr/3.serveex/3.security/4.pocket-id.md | 4 ++-- content/fr/3.serveex/4.monitoring/5.upsnap.md | 2 +- content/fr/3.serveex/5.media/3.servarr.md | 4 ++-- content/fr/3.serveex/9.apps/1.adguard.md | 10 ++++++++-- content/fr/3.serveex/91.advanced/1.authentik.md | 4 ++-- .../3.alternatives/3.servarr for plex.md | 4 ++-- 24 files changed, 105 insertions(+), 57 deletions(-) diff --git a/content/en/2.general/2.networking/3.samba.md b/content/en/2.general/2.networking/3.samba.md index 77cd2ae..3ef7bf7 100644 --- a/content/en/2.general/2.networking/3.samba.md +++ b/content/en/2.general/2.networking/3.samba.md @@ -6,7 +6,7 @@ description: Set up Samba on Debian to share folders over your local network and :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -Samba is a protocol that allows access to a folder located on a network drive. It can be configured on macOS, Windows, or Linux. +Samba is a free implementation of the SMB/CIFS protocol, allowing access to a folder located on a network drive. It can be configured on macOS, Windows, or Linux. There are many tutorials for setting up Samba on Windows or on NAS systems like Synology, but here we focus on Debian. @@ -146,11 +146,11 @@ sudo nano /smb/.credentials Write: ```properties [.credentials] -username=smbuser +username=sambauser password=password ``` -* `smbuser`: the user we created on the `remote-machine` +* `sambauser`: the user we created on the `remote-machine` * `password`: the password set earlier Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. @@ -199,7 +199,7 @@ sudo cp /etc/fstab /etc/fstab.bak Then add the mount configuration line: ```bash [Terminal] -sudo echo //remote-ip/video /mnt/video cifs _netdev,nofail,credentials=/smb/.credentials,x-systemd.automount,x-systemd.device-timeout=15 0 0 >> /etc/fstab +echo "//remote-ip/video /mnt/video cifs _netdev,nofail,credentials=/smb/.credentials,x-systemd.automount,x-systemd.device-timeout=15 0 0" | sudo tee -a /etc/fstab ``` Reboot the machine: diff --git a/content/en/3.serveex/2.core/2.docker.md b/content/en/3.serveex/2.core/2.docker.md index cd04add..bf2475b 100644 --- a/content/en/3.serveex/2.core/2.docker.md +++ b/content/en/3.serveex/2.core/2.docker.md @@ -157,6 +157,11 @@ services: - /var/run/docker.sock:/var/run/docker.sock ``` +::warning + +`WATCHTOWER_REMOVE_VOLUMES=true` deletes a container's anonymous volumes as soon as it's updated. Combined with a `latest` tag, an automatic update can silently wipe data for any app that still stores something in an anonymous (unnamed) volume instead of a bind mount. +:: + #### Set your environment variables Fill in the `.env` section in Dockge with the following: @@ -177,8 +182,11 @@ To have Watchtower monitor your other containers, add this to their `compose.yml ```yaml [compose.yaml] --- -labels: - - com.centurylinklabs.watchtower.enable=true +services: + yourapp: + # ... + labels: + - com.centurylinklabs.watchtower.enable=true ``` Then restart the modified stacks. diff --git a/content/en/3.serveex/2.core/3.wireguard.md b/content/en/3.serveex/2.core/3.wireguard.md index 768f1bc..12266bc 100644 --- a/content/en/3.serveex/2.core/3.wireguard.md +++ b/content/en/3.serveex/2.core/3.wireguard.md @@ -60,8 +60,7 @@ tree: - srv: - docker: - wg-easy: - - config: - - etc_wireguard/ + - etc_wireguard/ - compose.yaml - .env --- @@ -70,7 +69,7 @@ tree: ::steps{level="3"} ### Deploy the stack -Open Dockge, click **Compose**, and name the stack `wg_easy`. +Open Dockge, click **Compose**, and name the stack `wg-easy`. Copy the following configuration: @@ -79,7 +78,7 @@ Copy the following configuration: services: wg-easy: environment: - - INSECURE=true + - INSECURE=true # disables the web UI's own HTTPS; fine on a LAN-only or SWAG-fronted setup, remove it otherwise image: ghcr.io/wg-easy/wg-easy:15 container_name: wg-easy networks: @@ -148,8 +147,8 @@ Once connected, follow the web UI instructions to: Then go to *Administrator → Admin Panel → Config*: -- Change `Allowed IPs` from `0.0.0.0/24` to `10.8.0.0/24` for **split tunneling**. -- Remove IPv6 (it often causes unnecessary issues). +- Change `Allowed IPs` from the default `0.0.0.0/0` (full tunnel) to `10.8.0.0/24` for **split tunneling**. +- Optionally remove the IPv6 entry from `Allowed IPs` if you don't want client IPv6 traffic routed through the tunnel. This only affects what clients tunnel, not the container's own IPv6 setup above. ### Done ! :: diff --git a/content/en/3.serveex/2.core/4.swag.md b/content/en/3.serveex/2.core/4.swag.md index 8f8f274..198d9b5 100644 --- a/content/en/3.serveex/2.core/4.swag.md +++ b/content/en/3.serveex/2.core/4.swag.md @@ -390,7 +390,7 @@ Wait a moment, then visit `https://dockge.mydomain.com` in your browser. You sho SWAG includes templates for most known services, named `servicename.subdomain.conf.sample`. Just create the subdomain in your registrar's DNS zone (like OVH), point it to your main domain via a CNAME, then copy and rename the sample file: ```bash [Terminal] -cd /srv/docker/swag/config/proxy-confs +cd /srv/docker/swag/config/nginx/proxy-confs sudo cp servicename.subdomain.conf.sample servicename.subdomain.conf ``` diff --git a/content/en/3.serveex/3.security/2.cloudflare.md b/content/en/3.serveex/3.security/2.cloudflare.md index db4448e..deb2fa8 100644 --- a/content/en/3.serveex/3.security/2.cloudflare.md +++ b/content/en/3.serveex/3.security/2.cloudflare.md @@ -58,7 +58,7 @@ Once created, your token will only be shown once. Save it securely, as it cannot You must register for _Cloudflare Teams_ to access the _Zero Trust_ dashboard that manages tunnels and access policies. This is a premium service, but there’s a free plan for up to 50 users, perfect for a home lab. Keep in mind that a valid credit card is required to register, but the free plan incurs no charges. -Register [via this link](https://dash.teams.cloudflare.com/). +Register [via this link](https://one.dash.cloudflare.com/). ## SWAG Configuration ::note @@ -124,6 +124,17 @@ Save with :kbd{value="Ctrl+O"}, then :kbd{value="Enter"}, and exit with :kbd{val ### Deploy the SWAG stack +::warning + +This replaces your whole SWAG service definition. If you already added a `networks:` section or `EXTRA_DOMAINS` for other apps (Dockge, TinyAuth, etc.), merge those into the block below instead of pasting over them, or you'll lose that configuration. +:: + +Make sure the fail2ban database file already exists, or Docker will create a directory in its place instead of mounting the file, silently breaking ban persistence: + +```bash [Terminal] +sudo touch /srv/docker/swag/config/fail2ban/fail2ban.sqlite3 +``` + In Dockge, edit your SWAG stack with this: ```yaml [compose.yaml] @@ -190,7 +201,7 @@ TUNNEL_PW= | Variable | Value | Example | |----------------|-------------------------------------------------------------|--------------------------------| | `PUID` | User ID (`id username`) | `1000` | -| `GUID` | Group ID (`id username`) | `1000` | +| `PGID` | Group ID (`id username`) | `1000` | | `DOMAIN` | Your reserved domain | `mondomaine.fr` | | `PLUGIN` | DNS provider (also configure `cloudflare.ini`) | `cloudflare` | | `EMAIL` | Email for the certificate | `you@email.com` | diff --git a/content/en/3.serveex/3.security/3.tinyauth.md b/content/en/3.serveex/3.security/3.tinyauth.md index c1d5e78..1dd2097 100644 --- a/content/en/3.serveex/3.security/3.tinyauth.md +++ b/content/en/3.serveex/3.security/3.tinyauth.md @@ -64,7 +64,7 @@ services: volumes: - /srv/docker/tinyauth/data:/data ports: - - 3000:3000 + - 3002:3000 # host port only, avoids clashing with AdGuard's own 3000 ``` ::tip{icon=""} @@ -94,7 +94,7 @@ TINYAUTH_AUTH_USERS= | `TINYAUTH_APPURL`{lang=properties} | The public URL you'll use to reach TinyAuth (see exposure below) | `https://tinyauth.mydomain.com` | | `TINYAUTH_AUTH_USERS`{lang=properties} | The hash generated above | `user:$$2a$$10$$UdLYoJ5lgPsC0RKq...` | -Deploy the stack. The local interface is available at `http://yourserverip:3000`. +Deploy the stack. The local interface is available at `http://yourserverip:3002`. ### Done ! :: diff --git a/content/en/3.serveex/3.security/4.pocket-id.md b/content/en/3.serveex/3.security/4.pocket-id.md index 6a8ce8a..2e03b85 100644 --- a/content/en/3.serveex/3.security/4.pocket-id.md +++ b/content/en/3.serveex/3.security/4.pocket-id.md @@ -63,7 +63,7 @@ services: ports: - 1411:1411 healthcheck: - test: ["CMD", "curl", "-f", "http://localhost:1411/healthz"] + test: ["CMD", "/app/pocket-id", "healthcheck"] interval: 90s timeout: 5s retries: 3 @@ -111,7 +111,7 @@ Pocket ID doesn't use passwords: your first account is created with a **passkey* ::note -Since `APP_URL` is already set to your future public domain, passkey registration may ask you to open Pocket ID from that domain instead. Expose it first (see below) if setup doesn't complete locally. +Passkeys require a secure context: HTTPS, or `localhost`. Registering one from `http://yourserverip:1411` on another machine will be refused by the browser, since that's plain HTTP to a non-`localhost` address. If setup doesn't complete locally, expose Pocket ID first (see below) and finish setup over HTTPS instead. :: ## Exposing Pocket ID with Swag diff --git a/content/en/3.serveex/4.monitoring/5.upsnap.md b/content/en/3.serveex/4.monitoring/5.upsnap.md index f16d98c..8526cd2 100644 --- a/content/en/3.serveex/4.monitoring/5.upsnap.md +++ b/content/en/3.serveex/4.monitoring/5.upsnap.md @@ -71,7 +71,7 @@ services: Fill in the `.env`, for example: ```properties [.env] -RANGE=192.168.1.0/24 # scans all devices on the local network with an IP between 192.168.0.1 and 192.168.1.255 +SCAN_RANGE=192.168.1.0/24 # scans all devices on the local network with an IP between 192.168.1.1 and 192.168.1.254 DNS=192.168.1.1 # DNS IP to resolve domain names, typically your router’s IP ``` diff --git a/content/en/3.serveex/5.media/3.servarr.md b/content/en/3.serveex/5.media/3.servarr.md index 656e232..a1a7b49 100644 --- a/content/en/3.serveex/5.media/3.servarr.md +++ b/content/en/3.serveex/5.media/3.servarr.md @@ -162,14 +162,14 @@ Set your `.env` file with the variables below: ```properties [.env] PUID= -GUID= +PGID= MEDIA_PATH= ``` | Variable | Description | Example | |----------------|-------------------------------------------------------------------------------------------------|-------------| | `PUID` | Set using your user info (check with `id yourusername`) | `1000` | -| `GUID` | Same as above | `1000` | +| `PGID` | Same as above | `1000` | | `MEDIA_PATH` | Path to your media folder, here: `/media`. It must match the one used by Qbittorrent. | `/media` | ::note diff --git a/content/en/3.serveex/9.apps/1.adguard.md b/content/en/3.serveex/9.apps/1.adguard.md index 77e0438..e62504f 100644 --- a/content/en/3.serveex/9.apps/1.adguard.md +++ b/content/en/3.serveex/9.apps/1.adguard.md @@ -37,7 +37,7 @@ tree: /: - srv: - docker: - - adguard: + - adguardhome: - confdir/ - workdir/ - compose.yaml @@ -62,10 +62,11 @@ Name the stack `adguardhome` and paste the configuration below: services: adguardhome: container_name: adguard - image: adguard/adguardhome + image: adguard/adguardhome:latest restart: unless-stopped ports: - 53:53/udp + - 53:53/tcp - 8080:80/tcp - 4443:443/tcp - 853:853/tcp @@ -93,6 +94,11 @@ Deploy the stack. Go to `http://yourserverip:3000` and follow the setup instructions. +::warning + +The setup wizard asks you to pick an admin interface port. Keep it at `3000`: the SWAG configuration further down assumes the admin interface stays on that port, and changing it here would make exposing AdGuard with SWAG fail with a 502 error. +:: + ### Done ! :: diff --git a/content/en/3.serveex/91.advanced/1.authentik.md b/content/en/3.serveex/91.advanced/1.authentik.md index d25ed73..5c1fd2a 100644 --- a/content/en/3.serveex/91.advanced/1.authentik.md +++ b/content/en/3.serveex/91.advanced/1.authentik.md @@ -63,8 +63,8 @@ sudo mkdir -p /srv/docker/authentik/media /srv/docker/authentik/certs /srv/docke Navigate to the `authentik` folder via `cd /srv/docker/authentik` and generate a password and secret key to include in the `.env` file: ```bash [Terminal] -sudo echo "PG_PASS=$(openssl rand 36 | base64)" >> .env -sudo echo "AUTHENTIK_SECRET_KEY=$(openssl rand 60 | base64)" >> .env +echo "PG_PASS=$(openssl rand 36 | base64)" | sudo tee -a .env +echo "AUTHENTIK_SECRET_KEY=$(openssl rand 60 | base64)" | sudo tee -a .env ``` ::note diff --git a/content/en/6.recycled/3.alternatives/3.servarr for plex.md b/content/en/6.recycled/3.alternatives/3.servarr for plex.md index 77694ed..d2a1995 100644 --- a/content/en/6.recycled/3.alternatives/3.servarr for plex.md +++ b/content/en/6.recycled/3.alternatives/3.servarr for plex.md @@ -197,14 +197,14 @@ Set your `.env` file with the variables below: ```properties [.env] PUID= -GUID= +PGID= MEDIA_PATH= ``` | Variable | Description | Example | |----------------|-------------------------------------------------------------------------------------------------|-------------| | `PUID` | Set using your user info (check with `id yourusername`) | `1000` | -| `GUID` | Same as above | `1000` | +| `PGID` | Same as above | `1000` | | `MEDIA_PATH` | Path to your media folder, here: `/media`. It must match the one used by Qbittorrent. | `/media` | Deploy the stack. diff --git a/content/fr/2.general/2.networking/3.samba.md b/content/fr/2.general/2.networking/3.samba.md index 8e1449a..f509b48 100644 --- a/content/fr/2.general/2.networking/3.samba.md +++ b/content/fr/2.general/2.networking/3.samba.md @@ -6,7 +6,7 @@ description: Configurer Samba sur Debian pour partager des dossiers sur votre r :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -Samba est un protocole permettant d'accèder à un dossier situé sur un disque réseau. Il peut être configuré sous Mac, Windows ou Linux. +Samba est une implémentation libre du protocole SMB/CIFS, permettant d'accèder à un dossier situé sur un disque réseau. Il peut être configuré sous Mac, Windows ou Linux. De nombreux tutorials existent pour configurer Samba sous windows ou sur un NAS type Synology, ici nous nous concentrons sur Debian. @@ -94,7 +94,7 @@ A présent nous allons ajouter un utilisateur nologin c'est à dire que cet util sudo useradd -M -s /sbin/nologin sambauser ``` -Puis nous ajoutons l'utilisateur au groupe `sambashare` que nous avons créé précédemment. +Puis nous ajoutons l'utilisateur au groupe `smbshare` que nous avons créé précédemment. ```bash [Terminal] sudo usermod -aG smbshare sambauser @@ -146,11 +146,11 @@ sudo nano /smb/.credentials Configurez comme suit : ```properties [.credentials] -username=smbuser +username=sambauser password=motdepasse ``` -* `smbuser` : L'utilisateur que nous avons configuré sur la `machine-distante` +* `sambauser` : L'utilisateur que nous avons configuré sur la `machine-distante` * `motdepasse` : Le mot de passe que nous avons configuré sur la `machine-distante` Enregistrez avec :kbd{value="Ctrl+O"} puis :kbd{value="Entrée"}, puis quittez avec :kbd{value="Ctrl+X"}. @@ -199,7 +199,7 @@ sudo cp /etc/fstab /etc/fstab.bak Puis nous allons ajouter une ligne à la fin du fichier comportant les informations de montages dans le fichier `fstab`. ```bash [Terminal] -sudo echo //ip-machine-distante/video /mnt/video cifs _netdev,nofail,credentials=/smb/.credentials,x-systemd.automount,x-systemd.device-timeout=15 0 0 >> /etc/fstab +echo "//ip-machine-distante/video /mnt/video cifs _netdev,nofail,credentials=/smb/.credentials,x-systemd.automount,x-systemd.device-timeout=15 0 0" | sudo tee -a /etc/fstab ``` Redémarrez. diff --git a/content/fr/3.serveex/2.core/2.docker.md b/content/fr/3.serveex/2.core/2.docker.md index a296a79..b474a58 100644 --- a/content/fr/3.serveex/2.core/2.docker.md +++ b/content/fr/3.serveex/2.core/2.docker.md @@ -157,6 +157,11 @@ services: - /var/run/docker.sock:/var/run/docker.sock ``` +::warning + +`WATCHTOWER_REMOVE_VOLUMES=true` supprime les volumes anonymes d'un conteneur dès qu'il est mis à jour. Combiné à un tag `latest`, une mise à jour automatique peut silencieusement effacer les données de toute app qui stocke encore quelque chose dans un volume anonyme (sans nom) plutôt qu'un bind mount. +:: + #### Renseigner vos variables d'environnement Remplissez la section `.env` dans Dockge avec ce qui suit : @@ -177,8 +182,11 @@ Pour que Watchtower surveille vos autres conteneurs, ajoutez ceci à leur `compo ```yaml [compose.yaml] --- -labels: - - com.centurylinklabs.watchtower.enable=true +services: + votreapp: + # ... + labels: + - com.centurylinklabs.watchtower.enable=true ``` Redémarrez ensuite les stacks modifiées. diff --git a/content/fr/3.serveex/2.core/3.wireguard.md b/content/fr/3.serveex/2.core/3.wireguard.md index 3c5e66e..50b9688 100644 --- a/content/fr/3.serveex/2.core/3.wireguard.md +++ b/content/fr/3.serveex/2.core/3.wireguard.md @@ -60,8 +60,7 @@ tree: - srv: - docker: - wg-easy: - - config: - - etc_wireguard/ + - etc_wireguard/ - compose.yaml - .env --- @@ -70,7 +69,7 @@ tree: ::steps{level="3"} ### Déployer la stack -Ouvrez Dockge, cliquez sur **Compose**, et nommez la stack `wg_easy`. +Ouvrez Dockge, cliquez sur **Compose**, et nommez la stack `wg-easy`. Copiez la configuration suivante : @@ -79,7 +78,7 @@ Copiez la configuration suivante : services: wg-easy: environment: - - INSECURE=true + - INSECURE=true # désactive le HTTPS propre à l'interface web ; sans risque en LAN seul ou derrière SWAG, à retirer sinon image: ghcr.io/wg-easy/wg-easy:15 container_name: wg-easy networks: @@ -148,8 +147,8 @@ Une fois connecté, suivez les instructions de l'interface web pour : Allez ensuite dans *Administrator → Admin Panel → Config* : -- Remplacez `Allowed IPs` `0.0.0.0/24` par `10.8.0.0/24` pour du **split tunneling**. -- Supprimez l'IPv6 (il cause souvent des problèmes inutiles). +- Remplacez `Allowed IPs`, `0.0.0.0/0` par défaut (tunnel complet), par `10.8.0.0/24` pour du **split tunneling**. +- Retirez éventuellement l'entrée IPv6 de `Allowed IPs` si vous ne voulez pas router le trafic IPv6 des clients dans le tunnel. Cela ne change rien à la configuration IPv6 du conteneur ci-dessus, juste à ce que les clients y font transiter. ### Terminé ! :: diff --git a/content/fr/3.serveex/2.core/4.swag.md b/content/fr/3.serveex/2.core/4.swag.md index 72a21e1..456d4c8 100644 --- a/content/fr/3.serveex/2.core/4.swag.md +++ b/content/fr/3.serveex/2.core/4.swag.md @@ -390,7 +390,7 @@ Patientez un instant, puis visitez `https://dockge.mondomaine.fr` dans votre nav SWAG inclut des modèles pour la plupart des services connus, nommés `nomduservice.subdomain.conf.sample`. Il suffit de créer le sous-domaine dans la zone DNS de votre registrar (comme OVH), de le faire pointer vers votre domaine principal via un CNAME, puis de copier et renommer le fichier d'exemple : ```bash [Terminal] -cd /srv/docker/swag/config/proxy-confs +cd /srv/docker/swag/config/nginx/proxy-confs sudo cp nomduservice.subdomain.conf.sample nomduservice.subdomain.conf ``` diff --git a/content/fr/3.serveex/3.security/2.cloudflare.md b/content/fr/3.serveex/3.security/2.cloudflare.md index 308f245..b098f72 100644 --- a/content/fr/3.serveex/3.security/2.cloudflare.md +++ b/content/fr/3.serveex/3.security/2.cloudflare.md @@ -58,7 +58,7 @@ Une fois que nous aurons enregistré, notre jeton sera affiché une fois. copiez Vous devez vous inscrire à _Cloudflare Teams_ pour pouvoir accéder au tableau de bord _Zero Trust_ qui gère les tunnels et les politiques d'accès. Il s'agit d'un service premium, mais ils proposent un forfait gratuit pour un maximum de 50 utilisateurs, ce qui devrait suffire pour votre Home Lab. Gardez à l’esprit que puisqu’il s’agit d’une fonctionnalité premium, ils demandent une carte de crédit valide lors de l’inscription, mais avec le forfait gratuit, il n'y aura aucun frais. -Inscrivez-vous [via ce lien](https://dash.teams.cloudflare.com/). +Inscrivez-vous [via ce lien](https://one.dash.cloudflare.com/). ## Configuration de Swag ::note @@ -124,6 +124,17 @@ Enregistrez avec :kbd{value="Ctrl+O"} puis :kbd{value="Entrée"}, puis quittez a ### Déployer la stack SWAG +::warning + +Ceci remplace toute la définition du service SWAG. Si vous avez déjà ajouté une section `networks:` ou des `EXTRA_DOMAINS` pour d'autres apps (Dockge, TinyAuth, etc.), fusionnez-les avec le bloc ci-dessous au lieu de l'écraser, sinon vous perdrez cette configuration. +:: + +Assurez-vous que le fichier de base fail2ban existe déjà, sinon Docker créera un dossier à sa place au lieu de monter le fichier, ce qui casse silencieusement la persistance des bannissements : + +```bash [Terminal] +sudo touch /srv/docker/swag/config/fail2ban/fail2ban.sqlite3 +``` + Ouvrez Dockge, éditez la stack SWAG avec cette configuration ```yaml [compose.yaml] @@ -190,7 +201,7 @@ TUNNEL_PW= | Variable | Valeur | Exemples | |-----------------------------------|-----------------------------------------------------------------------------------------------------------|--------------------------------| | `PUID`{lang=properties} | A renseigner avec les infos de votre user (trouvables via la commande `id nomdutilisateur`{lang=shell}) | `1000` | -| `GUID`{lang=properties} | A renseigner avec les infos de votre user (trouvables via la commande `id nomdutilisateur`{lang=shell}) | `1000 ` | +| `PGID`{lang=properties} | A renseigner avec les infos de votre user (trouvables via la commande `id nomdutilisateur`{lang=shell}) | `1000 ` | | `DOMAIN`{lang=properties} | Le domaine que vous avez réservé | `mondomaine.fr` | | `PLUGIN`{lang=properties} | Le fournisseur de zone DNS, ici Cloudflare. Pensez à renseigner `cloudflare.ini` (voir [guide de swag](https://docs.linuxserver.io/general/swag/#create-container-via-dns-validation-with-a-wildcard-cert)) | `cloudflare` | | `EMAIL`{lang=properties} | Votre email pour le certificat | `votre@email.fr` | diff --git a/content/fr/3.serveex/3.security/3.tinyauth.md b/content/fr/3.serveex/3.security/3.tinyauth.md index e97a55a..f3eb292 100644 --- a/content/fr/3.serveex/3.security/3.tinyauth.md +++ b/content/fr/3.serveex/3.security/3.tinyauth.md @@ -64,7 +64,7 @@ services: volumes: - /srv/docker/tinyauth/data:/data ports: - - 3000:3000 + - 3002:3000 # port hôte uniquement, évite le conflit avec le 3000 d'AdGuard ``` ::tip{icon=""} @@ -94,7 +94,7 @@ TINYAUTH_AUTH_USERS= | `TINYAUTH_APPURL`{lang=properties} | L'URL publique par laquelle vous joindrez TinyAuth (voir l'exposition plus bas) | `https://tinyauth.mondomaine.fr` | | `TINYAUTH_AUTH_USERS`{lang=properties} | Le hash généré ci-dessus | `user:$$2a$$10$$UdLYoJ5lgPsC0RKq...` | -Déployez la stack. L'interface locale est disponible sur `http://ipdevotreserveur:3000`. +Déployez la stack. L'interface locale est disponible sur `http://ipdevotreserveur:3002`. ### Terminé ! :: diff --git a/content/fr/3.serveex/3.security/4.pocket-id.md b/content/fr/3.serveex/3.security/4.pocket-id.md index 9e2d46b..247ec74 100644 --- a/content/fr/3.serveex/3.security/4.pocket-id.md +++ b/content/fr/3.serveex/3.security/4.pocket-id.md @@ -63,7 +63,7 @@ services: ports: - 1411:1411 healthcheck: - test: ["CMD", "curl", "-f", "http://localhost:1411/healthz"] + test: ["CMD", "/app/pocket-id", "healthcheck"] interval: 90s timeout: 5s retries: 3 @@ -111,7 +111,7 @@ Pocket ID n'utilise pas de mots de passe : votre premier compte est créé avec ::note -Comme `APP_URL` pointe déjà vers votre futur domaine public, l'enregistrement de la passkey peut vous demander d'ouvrir Pocket ID depuis ce domaine. Exposez-le d'abord (voir plus bas) si la configuration ne se termine pas en local. +Les passkeys exigent un contexte sécurisé : HTTPS, ou `localhost`. Enregistrer une passkey depuis `http://ipdevotreserveur:1411` sur une autre machine sera refusé par le navigateur, puisque c'est du HTTP simple vers une adresse qui n'est pas `localhost`. Si la configuration ne se termine pas en local, exposez d'abord Pocket ID (voir plus bas) et terminez la configuration en HTTPS. :: ## Exposer Pocket ID avec Swag diff --git a/content/fr/3.serveex/4.monitoring/5.upsnap.md b/content/fr/3.serveex/4.monitoring/5.upsnap.md index 54a98eb..4192898 100644 --- a/content/fr/3.serveex/4.monitoring/5.upsnap.md +++ b/content/fr/3.serveex/4.monitoring/5.upsnap.md @@ -71,7 +71,7 @@ services: Remplissez le `.env`, par exemple : ```properties [.env] -RANGE=192.168.1.0/24 # scanne tous les appareils du réseau local ayant une IP entre 192.168.0.1 et 192.168.1.255 +SCAN_RANGE=192.168.1.0/24 # scanne tous les appareils du réseau local ayant une IP entre 192.168.1.1 et 192.168.1.254 DNS=192.168.1.1 # IP du DNS pour résoudre les noms de domaine, typiquement l'IP de votre box ``` diff --git a/content/fr/3.serveex/5.media/3.servarr.md b/content/fr/3.serveex/5.media/3.servarr.md index 03f2fbd..b73aae0 100644 --- a/content/fr/3.serveex/5.media/3.servarr.md +++ b/content/fr/3.serveex/5.media/3.servarr.md @@ -162,14 +162,14 @@ Renseignez votre fichier `.env` avec les variables ci-dessous : ```properties [.env] PUID= -GUID= +PGID= MEDIA_PATH= ``` | Variable | Description | Exemple | |----------------|-------------------------------------------------------------------------------------------------|-------------| | `PUID` | À renseigner avec vos informations utilisateur (à vérifier avec `id votreutilisateur`) | `1000` | -| `GUID` | Idem | `1000` | +| `PGID` | Idem | `1000` | | `MEDIA_PATH` | Chemin de votre dossier média, ici `/media`. Il doit correspondre à celui utilisé par Qbittorrent. | `/media` | ::note diff --git a/content/fr/3.serveex/9.apps/1.adguard.md b/content/fr/3.serveex/9.apps/1.adguard.md index 4ee2e6a..f136022 100644 --- a/content/fr/3.serveex/9.apps/1.adguard.md +++ b/content/fr/3.serveex/9.apps/1.adguard.md @@ -37,7 +37,7 @@ tree: /: - srv: - docker: - - adguard: + - adguardhome: - confdir/ - workdir/ - compose.yaml @@ -62,10 +62,11 @@ Nommez la stack `adguardhome` et collez la configuration ci-dessous : services: adguardhome: container_name: adguard - image: adguard/adguardhome + image: adguard/adguardhome:latest restart: unless-stopped ports: - 53:53/udp + - 53:53/tcp - 8080:80/tcp - 4443:443/tcp - 853:853/tcp @@ -93,6 +94,11 @@ Déployez la stack. Allez sur `http://ipdevotreserveur:3000` et suivez les instructions de configuration. +::warning + +L'assistant de configuration vous demande de choisir un port pour l'interface d'administration. Gardez `3000` : la configuration SWAG plus bas suppose que l'interface reste sur ce port, et le changer ici ferait échouer l'exposition d'AdGuard avec SWAG (erreur 502). +:: + ### Terminé ! :: diff --git a/content/fr/3.serveex/91.advanced/1.authentik.md b/content/fr/3.serveex/91.advanced/1.authentik.md index dca5884..18a10c2 100644 --- a/content/fr/3.serveex/91.advanced/1.authentik.md +++ b/content/fr/3.serveex/91.advanced/1.authentik.md @@ -63,8 +63,8 @@ sudo mkdir -p /srv/docker/authentik/media /srv/docker/authentik/certs /srv/docke Placez-vous dans le dossier `authentik` avec `cd /srv/docker/authentik` et générez un mot de passe et une clé secrète à inclure dans le fichier `.env` : ```bash [Terminal] -sudo echo "PG_PASS=$(openssl rand 36 | base64)" >> .env -sudo echo "AUTHENTIK_SECRET_KEY=$(openssl rand 60 | base64)" >> .env +echo "PG_PASS=$(openssl rand 36 | base64)" | sudo tee -a .env +echo "AUTHENTIK_SECRET_KEY=$(openssl rand 60 | base64)" | sudo tee -a .env ``` ::note diff --git a/content/fr/6.recycled/3.alternatives/3.servarr for plex.md b/content/fr/6.recycled/3.alternatives/3.servarr for plex.md index a3499ee..d75c980 100644 --- a/content/fr/6.recycled/3.alternatives/3.servarr for plex.md +++ b/content/fr/6.recycled/3.alternatives/3.servarr for plex.md @@ -197,14 +197,14 @@ Renseignez votre fichier `.env` avec les variables ci-dessous : ```properties [.env] PUID= -GUID= +PGID= MEDIA_PATH= ``` | Variable | Description | Exemple | |----------------|-------------------------------------------------------------------------------------------------|-------------| | `PUID` | À renseigner avec vos informations utilisateur (à vérifier avec `id votreutilisateur`) | `1000` | -| `GUID` | Idem | `1000` | +| `PGID` | Idem | `1000` | | `MEDIA_PATH` | Chemin de votre dossier média, ici `/media`. Il doit correspondre à celui utilisé par Qbittorrent. | `/media` | Déployez la stack. -- 2.54.0 From 6a27518be19f6c08f3fd01a83f22b6aff460e357 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:09:23 +0200 Subject: [PATCH 02/20] Fix compose network snippet indentation across app articles --- content/en/3.serveex/3.security/3.tinyauth.md | 4 ++-- content/en/3.serveex/3.security/4.pocket-id.md | 4 ++-- content/en/3.serveex/4.monitoring/1.uptime-kuma.md | 4 ++-- content/en/3.serveex/4.monitoring/2.dozzle.md | 4 ++-- content/en/3.serveex/4.monitoring/4.beszel.md | 4 ++-- content/en/3.serveex/4.monitoring/5.upsnap.md | 4 ++-- content/en/3.serveex/5.media/3.servarr.md | 6 +++--- content/en/3.serveex/6.cloud/1.immich.md | 4 ++-- content/en/3.serveex/6.cloud/2.nextcloud.md | 4 ++-- .../en/3.serveex/7.files/1.file-browser-quantum.md | 4 ++-- content/en/3.serveex/7.files/2.pingvin.md | 4 ++-- .../en/3.serveex/8.development/1.code-server.md | 4 ++-- content/en/3.serveex/8.development/2.forgejo.md | 4 ++-- content/en/3.serveex/8.development/3.it-tools.md | 4 ++-- content/en/3.serveex/9.apps/1.adguard.md | 4 ++-- content/en/3.serveex/9.apps/2.vaultwarden.md | 4 ++-- content/en/3.serveex/91.advanced/1.authentik.md | 14 +++++++------- content/en/3.serveex/91.advanced/2.arcane.md | 4 ++-- .../en/6.recycled/2.deprecated/2.file-browser.md | 4 ++-- content/en/6.recycled/3.alternatives/1.plex.md | 6 +++--- .../3.alternatives/3.servarr for plex.md | 6 +++--- content/en/6.recycled/3.alternatives/4.gitea.md | 4 ++-- content/fr/3.serveex/3.security/3.tinyauth.md | 4 ++-- content/fr/3.serveex/3.security/4.pocket-id.md | 4 ++-- content/fr/3.serveex/4.monitoring/1.uptime-kuma.md | 4 ++-- content/fr/3.serveex/4.monitoring/2.dozzle.md | 4 ++-- content/fr/3.serveex/4.monitoring/4.beszel.md | 4 ++-- content/fr/3.serveex/4.monitoring/5.upsnap.md | 4 ++-- content/fr/3.serveex/5.media/3.servarr.md | 6 +++--- content/fr/3.serveex/6.cloud/1.immich.md | 4 ++-- content/fr/3.serveex/6.cloud/2.nextcloud.md | 4 ++-- .../fr/3.serveex/7.files/1.file-browser-quantum.md | 4 ++-- content/fr/3.serveex/7.files/2.pingvin.md | 4 ++-- .../fr/3.serveex/8.development/1.code-server.md | 4 ++-- content/fr/3.serveex/8.development/2.forgejo.md | 4 ++-- content/fr/3.serveex/8.development/3.it-tools.md | 4 ++-- content/fr/3.serveex/9.apps/1.adguard.md | 4 ++-- content/fr/3.serveex/9.apps/2.vaultwarden.md | 4 ++-- content/fr/3.serveex/91.advanced/1.authentik.md | 14 +++++++------- content/fr/3.serveex/91.advanced/2.arcane.md | 4 ++-- .../fr/6.recycled/2.deprecated/2.file-browser.md | 4 ++-- content/fr/6.recycled/3.alternatives/1.plex.md | 6 +++--- .../3.alternatives/3.servarr for plex.md | 6 +++--- content/fr/6.recycled/3.alternatives/4.gitea.md | 4 ++-- 44 files changed, 104 insertions(+), 104 deletions(-) diff --git a/content/en/3.serveex/3.security/3.tinyauth.md b/content/en/3.serveex/3.security/3.tinyauth.md index 1dd2097..d7f2d81 100644 --- a/content/en/3.serveex/3.security/3.tinyauth.md +++ b/content/en/3.serveex/3.security/3.tinyauth.md @@ -152,9 +152,9 @@ Go to Dockge and edit SWAG's compose file by adding TinyAuth's network: --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Attach container to custom network + networks: # Attach container to custom network # ... - tinyauth # Name of the declared network diff --git a/content/en/3.serveex/3.security/4.pocket-id.md b/content/en/3.serveex/3.security/4.pocket-id.md index 2e03b85..1221214 100644 --- a/content/en/3.serveex/3.security/4.pocket-id.md +++ b/content/en/3.serveex/3.security/4.pocket-id.md @@ -131,9 +131,9 @@ Go to Dockge and edit SWAG's compose file by adding Pocket ID's network: --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Attach container to custom network + networks: # Attach container to custom network # ... - pocket-id # Name of the declared network diff --git a/content/en/3.serveex/4.monitoring/1.uptime-kuma.md b/content/en/3.serveex/4.monitoring/1.uptime-kuma.md index 8213fce..5fff270 100644 --- a/content/en/3.serveex/4.monitoring/1.uptime-kuma.md +++ b/content/en/3.serveex/4.monitoring/1.uptime-kuma.md @@ -153,9 +153,9 @@ In Dockge, edit the SWAG compose and add the Uptime-Kuma network: --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Link container to custom network + networks: # Link container to custom network # ... - uptime-kuma # Name of the declared network diff --git a/content/en/3.serveex/4.monitoring/2.dozzle.md b/content/en/3.serveex/4.monitoring/2.dozzle.md index a5aa945..579fa9f 100644 --- a/content/en/3.serveex/4.monitoring/2.dozzle.md +++ b/content/en/3.serveex/4.monitoring/2.dozzle.md @@ -97,9 +97,9 @@ Go to Dockge and edit the SWAG compose file to add Dozzle’s network: --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to a custom network + networks: # Connects the container to a custom network # ... - dozzle # Network name declared in the stack diff --git a/content/en/3.serveex/4.monitoring/4.beszel.md b/content/en/3.serveex/4.monitoring/4.beszel.md index cf073c4..e1b6ea5 100644 --- a/content/en/3.serveex/4.monitoring/4.beszel.md +++ b/content/en/3.serveex/4.monitoring/4.beszel.md @@ -167,9 +167,9 @@ In Dockge, edit Swag's compose file and add Beszel’s network: --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: + networks: # ... - beszel # network declared in the stack diff --git a/content/en/3.serveex/4.monitoring/5.upsnap.md b/content/en/3.serveex/4.monitoring/5.upsnap.md index 8526cd2..a6c8537 100644 --- a/content/en/3.serveex/4.monitoring/5.upsnap.md +++ b/content/en/3.serveex/4.monitoring/5.upsnap.md @@ -109,9 +109,9 @@ Go to Dockge, and edit the SWAG compose by adding the UpSnap network: --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to the custom network + networks: # Connects the container to the custom network # ... - upsnap # Network name declared in the stack diff --git a/content/en/3.serveex/5.media/3.servarr.md b/content/en/3.serveex/5.media/3.servarr.md index a1a7b49..79f97e1 100644 --- a/content/en/3.serveex/5.media/3.servarr.md +++ b/content/en/3.serveex/5.media/3.servarr.md @@ -26,7 +26,7 @@ tree: - srv: - docker: - jellyfin: - - compose.yml + - compose.yaml - .env - config/ - sonarr: @@ -406,9 +406,9 @@ Go to Dockge, edit the SWAG compose file, and add the Seerr network, which is th --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to a custom network + networks: # Connects the container to a custom network # ... - jellyfin # Name of the network declared in the stack diff --git a/content/en/3.serveex/6.cloud/1.immich.md b/content/en/3.serveex/6.cloud/1.immich.md index 1fefa9e..5f5a8b6 100644 --- a/content/en/3.serveex/6.cloud/1.immich.md +++ b/content/en/3.serveex/6.cloud/1.immich.md @@ -71,9 +71,9 @@ In Dockge, open the SWAG stack and edit the compose file to add Immich's network --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to the custom network + networks: # Connects the container to the custom network # ... - immich # Network name defined in the stack diff --git a/content/en/3.serveex/6.cloud/2.nextcloud.md b/content/en/3.serveex/6.cloud/2.nextcloud.md index 02e5970..6d241cc 100644 --- a/content/en/3.serveex/6.cloud/2.nextcloud.md +++ b/content/en/3.serveex/6.cloud/2.nextcloud.md @@ -101,9 +101,9 @@ In Dockge, go to your SWAG stack and edit the compose to add Nextcloud's network --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: + networks: # ... - nextcloud diff --git a/content/en/3.serveex/7.files/1.file-browser-quantum.md b/content/en/3.serveex/7.files/1.file-browser-quantum.md index 69bca9c..046f906 100644 --- a/content/en/3.serveex/7.files/1.file-browser-quantum.md +++ b/content/en/3.serveex/7.files/1.file-browser-quantum.md @@ -127,9 +127,9 @@ In Dockge, go to the SWAG stack and edit the compose file to add File Browser Qu --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to the custom network + networks: # Connects the container to the custom network # ... - filebrowser-quantum # Name of the network declared in the stack diff --git a/content/en/3.serveex/7.files/2.pingvin.md b/content/en/3.serveex/7.files/2.pingvin.md index 9f5082c..11d0cbf 100644 --- a/content/en/3.serveex/7.files/2.pingvin.md +++ b/content/en/3.serveex/7.files/2.pingvin.md @@ -91,9 +91,9 @@ In Dockge, go to the SWAG stack and edit the compose file to add the pingvin net --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to the custom network + networks: # Connects the container to the custom network # ... - pingvin # Name of the network declared in the stack diff --git a/content/en/3.serveex/8.development/1.code-server.md b/content/en/3.serveex/8.development/1.code-server.md index 761535a..26cad0e 100644 --- a/content/en/3.serveex/8.development/1.code-server.md +++ b/content/en/3.serveex/8.development/1.code-server.md @@ -135,9 +135,9 @@ In Dockge, go to the SWAG stack and edit the compose file to add code-server’s --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to a custom network + networks: # Connects the container to a custom network # ... - code-server # Name of the network defined in the stack diff --git a/content/en/3.serveex/8.development/2.forgejo.md b/content/en/3.serveex/8.development/2.forgejo.md index 0a20b55..cadcb6e 100644 --- a/content/en/3.serveex/8.development/2.forgejo.md +++ b/content/en/3.serveex/8.development/2.forgejo.md @@ -90,9 +90,9 @@ In Dockge, go to the SWAG stack and edit the compose file by adding Forgejo's ne --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connect the container to the custom network + networks: # Connect the container to the custom network # ... - forgejo # Name of the declared network diff --git a/content/en/3.serveex/8.development/3.it-tools.md b/content/en/3.serveex/8.development/3.it-tools.md index cec03d2..c383806 100644 --- a/content/en/3.serveex/8.development/3.it-tools.md +++ b/content/en/3.serveex/8.development/3.it-tools.md @@ -68,9 +68,9 @@ In Dockge, go to the SWAG stack and edit the compose file to add the IT Tools ne --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to the custom network + networks: # Connects the container to the custom network # ... - it-tools # Network name as defined in the IT Tools stack diff --git a/content/en/3.serveex/9.apps/1.adguard.md b/content/en/3.serveex/9.apps/1.adguard.md index e62504f..4b0d50b 100644 --- a/content/en/3.serveex/9.apps/1.adguard.md +++ b/content/en/3.serveex/9.apps/1.adguard.md @@ -126,9 +126,9 @@ In Dockge, go to the SWAG stack and edit the compose file to add the AdGuard net --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connect the container to the custom network + networks: # Connect the container to the custom network # ... - adguard # Name of the network declared in the stack diff --git a/content/en/3.serveex/9.apps/2.vaultwarden.md b/content/en/3.serveex/9.apps/2.vaultwarden.md index eed3fce..f896236 100644 --- a/content/en/3.serveex/9.apps/2.vaultwarden.md +++ b/content/en/3.serveex/9.apps/2.vaultwarden.md @@ -124,9 +124,9 @@ In Dockge, go to the SWAG stack and edit the compose file to add the Vaultwarden --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects container to custom network + networks: # Connects container to custom network # ... - vaultwarden # Name of the declared network diff --git a/content/en/3.serveex/91.advanced/1.authentik.md b/content/en/3.serveex/91.advanced/1.authentik.md index 5c1fd2a..7e1f7a1 100644 --- a/content/en/3.serveex/91.advanced/1.authentik.md +++ b/content/en/3.serveex/91.advanced/1.authentik.md @@ -43,7 +43,7 @@ tree: - docker: - authentik: - .env - - compose.yml + - compose.yaml - media/ - certs/ - custom-template/ @@ -69,9 +69,9 @@ echo "AUTHENTIK_SECRET_KEY=$(openssl rand 60 | base64)" | sudo tee -a .env ::note -To generate the keys, we created the folders ahead of deployment using Dockge. Dockge will prevent you from creating a stack with the same name in these folders unless a `compose.yml` file exists. So, create an empty `compose.yml` so it appears as an inactive stack: +To generate the keys, we created the folders ahead of deployment using Dockge. Dockge will prevent you from creating a stack with the same name in these folders unless a `compose.yaml` file exists. So, create an empty `compose.yaml` so it appears as an inactive stack: ```bash [Terminal] - sudo nano /srv/docker/authentik/compose.yml + sudo nano /srv/docker/authentik/compose.yaml ``` :: @@ -284,9 +284,9 @@ Go to Dockge, and edit the SWAG compose file to add the Authentik network: --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Attach the container to the custom network + networks: # Attach the container to the custom network # ... - authentik # Name of the network declared in the stack @@ -493,9 +493,9 @@ sudo nano /srv/docker/swag/compose.yaml --- services: swag: - container_name: #... + container_name: #... # ... - networks: # Attach the container to the custom network + networks: # Attach the container to the custom network - authentik-outpost # Network name as declared in the stack diff --git a/content/en/3.serveex/91.advanced/2.arcane.md b/content/en/3.serveex/91.advanced/2.arcane.md index 7cd28ba..96000ac 100644 --- a/content/en/3.serveex/91.advanced/2.arcane.md +++ b/content/en/3.serveex/91.advanced/2.arcane.md @@ -172,9 +172,9 @@ Go to Dockge and edit SWAG's compose file by adding Arcane's network: --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Attach container to custom network + networks: # Attach container to custom network # ... - arcane # Name of the declared network diff --git a/content/en/6.recycled/2.deprecated/2.file-browser.md b/content/en/6.recycled/2.deprecated/2.file-browser.md index fe2febf..e7806e2 100644 --- a/content/en/6.recycled/2.deprecated/2.file-browser.md +++ b/content/en/6.recycled/2.deprecated/2.file-browser.md @@ -81,9 +81,9 @@ In Dockge, go to the SWAG stack and edit the compose file to add File Browser’ --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to the custom network + networks: # Connects the container to the custom network # ... - filebrowser # Name of the network declared in the stack diff --git a/content/en/6.recycled/3.alternatives/1.plex.md b/content/en/6.recycled/3.alternatives/1.plex.md index 56b0e06..0526c7a 100644 --- a/content/en/6.recycled/3.alternatives/1.plex.md +++ b/content/en/6.recycled/3.alternatives/1.plex.md @@ -36,7 +36,7 @@ tree: - srv: - docker: - plex: - - compose.yml + - compose.yaml - .env - config/ - transcode/ @@ -192,9 +192,9 @@ Go to Dockge and edit SWAG’s compose file by adding Tautulli’s network: --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Attach container to custom network + networks: # Attach container to custom network # ... - tautulli # Name of the declared network diff --git a/content/en/6.recycled/3.alternatives/3.servarr for plex.md b/content/en/6.recycled/3.alternatives/3.servarr for plex.md index d2a1995..5c88410 100644 --- a/content/en/6.recycled/3.alternatives/3.servarr for plex.md +++ b/content/en/6.recycled/3.alternatives/3.servarr for plex.md @@ -31,7 +31,7 @@ tree: - srv: - docker: - plex: - - compose.yml + - compose.yaml - config/ - transcode/ - tautulli: @@ -427,9 +427,9 @@ Go to Dockge, edit the SWAG compose file, and add the Overseerr network, which i --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to a custom network + networks: # Connects the container to a custom network # ... - plex # Name of the network declared in the stack diff --git a/content/en/6.recycled/3.alternatives/4.gitea.md b/content/en/6.recycled/3.alternatives/4.gitea.md index f803d34..f99f624 100644 --- a/content/en/6.recycled/3.alternatives/4.gitea.md +++ b/content/en/6.recycled/3.alternatives/4.gitea.md @@ -92,9 +92,9 @@ In Dockge, go to the SWAG stack and edit the compose file by adding Gitea's netw --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connect the container to the custom network + networks: # Connect the container to the custom network # ... - gitea # Name of the declared network diff --git a/content/fr/3.serveex/3.security/3.tinyauth.md b/content/fr/3.serveex/3.security/3.tinyauth.md index f3eb292..8409028 100644 --- a/content/fr/3.serveex/3.security/3.tinyauth.md +++ b/content/fr/3.serveex/3.security/3.tinyauth.md @@ -152,9 +152,9 @@ Allez dans Dockge et modifiez le fichier compose de SWAG en y ajoutant le résea --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - tinyauth # Nom du réseau déclaré diff --git a/content/fr/3.serveex/3.security/4.pocket-id.md b/content/fr/3.serveex/3.security/4.pocket-id.md index 247ec74..ff34e47 100644 --- a/content/fr/3.serveex/3.security/4.pocket-id.md +++ b/content/fr/3.serveex/3.security/4.pocket-id.md @@ -131,9 +131,9 @@ Allez dans Dockge et modifiez le fichier compose de SWAG en y ajoutant le résea --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - pocket-id # Nom du réseau déclaré diff --git a/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md b/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md index 38d3481..294a79b 100644 --- a/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md +++ b/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md @@ -153,9 +153,9 @@ Dans Dockge, modifiez le compose de SWAG et ajoutez le réseau d'Uptime-Kuma : --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Relie le conteneur au réseau personnalisé + networks: # Relie le conteneur au réseau personnalisé # ... - uptime-kuma # Nom du réseau déclaré diff --git a/content/fr/3.serveex/4.monitoring/2.dozzle.md b/content/fr/3.serveex/4.monitoring/2.dozzle.md index 16d10f7..7e37edb 100644 --- a/content/fr/3.serveex/4.monitoring/2.dozzle.md +++ b/content/fr/3.serveex/4.monitoring/2.dozzle.md @@ -97,9 +97,9 @@ Allez dans Dockge et modifiez le fichier compose de SWAG pour y ajouter le rése --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur à un réseau personnalisé + networks: # Rattache le conteneur à un réseau personnalisé # ... - dozzle # Nom du réseau déclaré dans la stack diff --git a/content/fr/3.serveex/4.monitoring/4.beszel.md b/content/fr/3.serveex/4.monitoring/4.beszel.md index dc13dc6..cd67c3f 100644 --- a/content/fr/3.serveex/4.monitoring/4.beszel.md +++ b/content/fr/3.serveex/4.monitoring/4.beszel.md @@ -167,9 +167,9 @@ Dans Dockge, modifiez le fichier compose de Swag et ajoutez le réseau de Beszel --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: + networks: # ... - beszel # réseau déclaré dans la stack diff --git a/content/fr/3.serveex/4.monitoring/5.upsnap.md b/content/fr/3.serveex/4.monitoring/5.upsnap.md index 4192898..c83fdfd 100644 --- a/content/fr/3.serveex/4.monitoring/5.upsnap.md +++ b/content/fr/3.serveex/4.monitoring/5.upsnap.md @@ -109,9 +109,9 @@ Allez dans Dockge et modifiez le compose de SWAG en y ajoutant le réseau d'UpSn --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - upsnap # Nom du réseau déclaré dans la stack diff --git a/content/fr/3.serveex/5.media/3.servarr.md b/content/fr/3.serveex/5.media/3.servarr.md index b73aae0..a390482 100644 --- a/content/fr/3.serveex/5.media/3.servarr.md +++ b/content/fr/3.serveex/5.media/3.servarr.md @@ -26,7 +26,7 @@ tree: - srv: - docker: - jellyfin: - - compose.yml + - compose.yaml - .env - config/ - sonarr: @@ -406,9 +406,9 @@ Allez dans Dockge, modifiez le fichier compose de SWAG, et ajoutez le réseau de --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to a custom network + networks: # Connects the container to a custom network # ... - jellyfin # Name of the network declared in the stack diff --git a/content/fr/3.serveex/6.cloud/1.immich.md b/content/fr/3.serveex/6.cloud/1.immich.md index 0411578..3b09557 100644 --- a/content/fr/3.serveex/6.cloud/1.immich.md +++ b/content/fr/3.serveex/6.cloud/1.immich.md @@ -71,9 +71,9 @@ Dans Dockge, ouvrez la stack SWAG et modifiez le fichier compose pour y ajouter --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - immich # Nom du réseau défini dans la stack diff --git a/content/fr/3.serveex/6.cloud/2.nextcloud.md b/content/fr/3.serveex/6.cloud/2.nextcloud.md index a9b458f..cdc1ccf 100644 --- a/content/fr/3.serveex/6.cloud/2.nextcloud.md +++ b/content/fr/3.serveex/6.cloud/2.nextcloud.md @@ -101,9 +101,9 @@ Dans Dockge, allez sur votre stack SWAG et modifiez le compose pour y ajouter le --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: + networks: # ... - nextcloud diff --git a/content/fr/3.serveex/7.files/1.file-browser-quantum.md b/content/fr/3.serveex/7.files/1.file-browser-quantum.md index e2f7a99..9a60d0e 100644 --- a/content/fr/3.serveex/7.files/1.file-browser-quantum.md +++ b/content/fr/3.serveex/7.files/1.file-browser-quantum.md @@ -127,9 +127,9 @@ Dans Dockge, allez sur la stack SWAG et modifiez le fichier compose pour y ajout --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - filebrowser-quantum # Nom du réseau déclaré dans la stack diff --git a/content/fr/3.serveex/7.files/2.pingvin.md b/content/fr/3.serveex/7.files/2.pingvin.md index 2b9d1c0..483b268 100644 --- a/content/fr/3.serveex/7.files/2.pingvin.md +++ b/content/fr/3.serveex/7.files/2.pingvin.md @@ -91,9 +91,9 @@ Dans Dockge, allez sur la stack SWAG et modifiez le fichier compose pour y ajout --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - pingvin # Nom du réseau déclaré dans la stack diff --git a/content/fr/3.serveex/8.development/1.code-server.md b/content/fr/3.serveex/8.development/1.code-server.md index f327b28..d1da7fd 100644 --- a/content/fr/3.serveex/8.development/1.code-server.md +++ b/content/fr/3.serveex/8.development/1.code-server.md @@ -135,9 +135,9 @@ Dans Dockge, allez sur la stack SWAG et modifiez le fichier compose pour y ajout --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur à un réseau personnalisé + networks: # Rattache le conteneur à un réseau personnalisé # ... - code-server # Nom du réseau défini dans la stack diff --git a/content/fr/3.serveex/8.development/2.forgejo.md b/content/fr/3.serveex/8.development/2.forgejo.md index 5e575c0..023087e 100644 --- a/content/fr/3.serveex/8.development/2.forgejo.md +++ b/content/fr/3.serveex/8.development/2.forgejo.md @@ -90,9 +90,9 @@ Dans Dockge, allez sur la stack SWAG et modifiez le fichier compose en y ajoutan --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - forgejo # Nom du réseau déclaré diff --git a/content/fr/3.serveex/8.development/3.it-tools.md b/content/fr/3.serveex/8.development/3.it-tools.md index 641af20..83df628 100644 --- a/content/fr/3.serveex/8.development/3.it-tools.md +++ b/content/fr/3.serveex/8.development/3.it-tools.md @@ -68,9 +68,9 @@ Dans Dockge, allez sur la stack SWAG et modifiez le fichier compose pour y ajout --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - it-tools # Nom du réseau tel que défini dans la stack IT Tools diff --git a/content/fr/3.serveex/9.apps/1.adguard.md b/content/fr/3.serveex/9.apps/1.adguard.md index f136022..aab4092 100644 --- a/content/fr/3.serveex/9.apps/1.adguard.md +++ b/content/fr/3.serveex/9.apps/1.adguard.md @@ -126,9 +126,9 @@ Dans Dockge, allez sur la stack SWAG et modifiez le fichier compose pour y ajout --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - adguard # Nom du réseau déclaré dans la stack diff --git a/content/fr/3.serveex/9.apps/2.vaultwarden.md b/content/fr/3.serveex/9.apps/2.vaultwarden.md index 62bd80a..3bf6439 100644 --- a/content/fr/3.serveex/9.apps/2.vaultwarden.md +++ b/content/fr/3.serveex/9.apps/2.vaultwarden.md @@ -124,9 +124,9 @@ Dans Dockge, allez sur la stack SWAG et modifiez le fichier compose pour y ajout --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - vaultwarden # Nom du réseau déclaré diff --git a/content/fr/3.serveex/91.advanced/1.authentik.md b/content/fr/3.serveex/91.advanced/1.authentik.md index 18a10c2..1183db7 100644 --- a/content/fr/3.serveex/91.advanced/1.authentik.md +++ b/content/fr/3.serveex/91.advanced/1.authentik.md @@ -43,7 +43,7 @@ tree: - docker: - authentik: - .env - - compose.yml + - compose.yaml - media/ - certs/ - custom-template/ @@ -69,9 +69,9 @@ echo "AUTHENTIK_SECRET_KEY=$(openssl rand 60 | base64)" | sudo tee -a .env ::note -Pour générer les clés, nous avons créé les dossiers avant le déploiement par Dockge. Dockge vous empêchera de créer une stack du même nom dans ces dossiers tant qu'un fichier `compose.yml` n'existe pas. Créez donc un `compose.yml` vide pour qu'elle apparaisse comme stack inactive : +Pour générer les clés, nous avons créé les dossiers avant le déploiement par Dockge. Dockge vous empêchera de créer une stack du même nom dans ces dossiers tant qu'un fichier `compose.yaml` n'existe pas. Créez donc un `compose.yaml` vide pour qu'elle apparaisse comme stack inactive : ```bash [Terminal] - sudo nano /srv/docker/authentik/compose.yml + sudo nano /srv/docker/authentik/compose.yaml ``` :: @@ -284,9 +284,9 @@ Allez dans Dockge, et modifiez le fichier compose de SWAG pour y ajouter le rés --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Attach the container to the custom network + networks: # Attach the container to the custom network # ... - authentik # Name of the network declared in the stack @@ -493,9 +493,9 @@ sudo nano /srv/docker/swag/compose.yaml --- services: swag: - container_name: #... + container_name: #... # ... - networks: # Attach the container to the custom network + networks: # Attach the container to the custom network - authentik-outpost # Network name as declared in the stack diff --git a/content/fr/3.serveex/91.advanced/2.arcane.md b/content/fr/3.serveex/91.advanced/2.arcane.md index 8438ef9..3755976 100644 --- a/content/fr/3.serveex/91.advanced/2.arcane.md +++ b/content/fr/3.serveex/91.advanced/2.arcane.md @@ -172,9 +172,9 @@ Allez dans Dockge et modifiez le fichier compose de SWAG en y ajoutant le résea --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - arcane # Nom du réseau déclaré diff --git a/content/fr/6.recycled/2.deprecated/2.file-browser.md b/content/fr/6.recycled/2.deprecated/2.file-browser.md index 64b9751..a69dfad 100644 --- a/content/fr/6.recycled/2.deprecated/2.file-browser.md +++ b/content/fr/6.recycled/2.deprecated/2.file-browser.md @@ -81,9 +81,9 @@ Dans Dockge, allez sur la stack SWAG et modifiez le fichier compose pour y ajout --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - filebrowser # Nom du réseau déclaré dans la stack diff --git a/content/fr/6.recycled/3.alternatives/1.plex.md b/content/fr/6.recycled/3.alternatives/1.plex.md index f396f60..b1befa7 100644 --- a/content/fr/6.recycled/3.alternatives/1.plex.md +++ b/content/fr/6.recycled/3.alternatives/1.plex.md @@ -36,7 +36,7 @@ tree: - srv: - docker: - plex: - - compose.yml + - compose.yaml - .env - config/ - transcode/ @@ -192,9 +192,9 @@ Allez dans Dockge et modifiez le fichier compose de SWAG en y ajoutant le résea --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - tautulli # Nom du réseau déclaré diff --git a/content/fr/6.recycled/3.alternatives/3.servarr for plex.md b/content/fr/6.recycled/3.alternatives/3.servarr for plex.md index d75c980..b8966e5 100644 --- a/content/fr/6.recycled/3.alternatives/3.servarr for plex.md +++ b/content/fr/6.recycled/3.alternatives/3.servarr for plex.md @@ -31,7 +31,7 @@ tree: - srv: - docker: - plex: - - compose.yml + - compose.yaml - config/ - transcode/ - tautulli: @@ -427,9 +427,9 @@ Allez dans Dockge, modifiez le fichier compose de SWAG, et ajoutez le réseau d' --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Connects the container to a custom network + networks: # Connects the container to a custom network # ... - plex # Name of the network declared in the stack diff --git a/content/fr/6.recycled/3.alternatives/4.gitea.md b/content/fr/6.recycled/3.alternatives/4.gitea.md index 6b037dd..da83d87 100644 --- a/content/fr/6.recycled/3.alternatives/4.gitea.md +++ b/content/fr/6.recycled/3.alternatives/4.gitea.md @@ -92,9 +92,9 @@ Dans Dockge, allez sur la stack SWAG et modifiez le fichier compose en y ajoutan --- services: swag: - container_name: # ... + container_name: # ... # ... - networks: # Rattache le conteneur au réseau personnalisé + networks: # Rattache le conteneur au réseau personnalisé # ... - gitea # Nom du réseau déclaré -- 2.54.0 From f9d95448db773f17bf58444f4af82fcacab82c28 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:09:34 +0200 Subject: [PATCH 03/20] Standardize on compose.yaml instead of compose.yml --- content/en/3.serveex/2.core/2.docker.md | 8 ++++---- content/en/3.serveex/2.core/4.swag.md | 6 +++--- content/en/3.serveex/4.monitoring/3.speedtest-tracker.md | 2 +- content/fr/3.serveex/2.core/2.docker.md | 8 ++++---- content/fr/3.serveex/2.core/4.swag.md | 6 +++--- content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md | 2 +- 6 files changed, 16 insertions(+), 16 deletions(-) diff --git a/content/en/3.serveex/2.core/2.docker.md b/content/en/3.serveex/2.core/2.docker.md index bf2475b..5830839 100644 --- a/content/en/3.serveex/2.core/2.docker.md +++ b/content/en/3.serveex/2.core/2.docker.md @@ -65,7 +65,7 @@ tree: - srv: - docker: - dockge: - - compose.yml + - compose.yaml --- :: @@ -81,7 +81,7 @@ sudo mkdir dockge ```bash [Terminal] cd /srv/docker/dockge -sudo nano compose.yml +sudo nano compose.yaml ``` Paste the following: @@ -122,7 +122,7 @@ More info on [Dockge and how to use it](https://github.com/louislam/dockge) And there you go! Docker and a tool to easily manage your containers are ready! ## [Watchtower](https://watchtower.nickfedor.com/), to auto-update containers -Watchtower is a container that checks for updates and pulls new images automatically, just by adding a label in your containers’ `compose.yml` files. +Watchtower is a container that checks for updates and pulls new images automatically, just by adding a label in your containers’ `compose.yaml` files. ### Configuration @@ -178,7 +178,7 @@ WH_URL= #### Enable Watchtower on other containers -To have Watchtower monitor your other containers, add this to their `compose.yml`: +To have Watchtower monitor your other containers, add this to their `compose.yaml`: ```yaml [compose.yaml] --- diff --git a/content/en/3.serveex/2.core/4.swag.md b/content/en/3.serveex/2.core/4.swag.md index 198d9b5..e5ccb26 100644 --- a/content/en/3.serveex/2.core/4.swag.md +++ b/content/en/3.serveex/2.core/4.swag.md @@ -42,7 +42,7 @@ tree: - nginx.conf - proxy-confs: - dockge.subdomain.conf - - compose.yml + - compose.yaml - .env --- :: @@ -348,7 +348,7 @@ Save and exit. The configuration will update within a few seconds. ::note -By default, SWAG doesn’t recognize the name "dockge". You’ll need to add Dockge’s network to SWAG’s `compose.yml`. +By default, SWAG doesn’t recognize the name "dockge". You’ll need to add Dockge’s network to SWAG’s `compose.yaml`. :: ### Add Dockge's network to SWAG @@ -398,7 +398,7 @@ sudo cp servicename.subdomain.conf.sample servicename.subdomain.conf __If the subdomain is not redirected properly__ - Open the file and verify the container name in `set $upstream_app containername;`{lang=nginx} -- Make sure you added the container's network in SWAG’s `compose.yml` +- Make sure you added the container's network in SWAG’s `compose.yaml` :: You can also customize the subdomain by editing `server_name yoursubdomain.*;`{lang=nginx} and renaming the file to `yoursubdomain.subdomain.conf`. diff --git a/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md b/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md index 6cf8054..1b8b43e 100644 --- a/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md +++ b/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md @@ -165,7 +165,7 @@ Save and exit. The configuration will update in a few seconds. ::note -By default, SWAG doesn’t know the name "speedtest-tracker". To allow access, you need to add Speedtest Tracker’s network to SWAG’s `compose.yml`. +By default, SWAG doesn’t know the name "speedtest-tracker". To allow access, you need to add Speedtest Tracker’s network to SWAG’s `compose.yaml`. :: Go to Dockge, and edit SWAG’s compose to include Speedtest Tracker’s network: diff --git a/content/fr/3.serveex/2.core/2.docker.md b/content/fr/3.serveex/2.core/2.docker.md index b474a58..43ca15f 100644 --- a/content/fr/3.serveex/2.core/2.docker.md +++ b/content/fr/3.serveex/2.core/2.docker.md @@ -65,7 +65,7 @@ tree: - srv: - docker: - dockge: - - compose.yml + - compose.yaml --- :: @@ -81,7 +81,7 @@ sudo mkdir dockge ```bash [Terminal] cd /srv/docker/dockge -sudo nano compose.yml +sudo nano compose.yaml ``` Collez ce qui suit : @@ -122,7 +122,7 @@ Plus d'infos sur [Dockge et son utilisation](https://github.com/louislam/dockge) Et voilà ! Docker et un outil pour gérer facilement vos conteneurs sont prêts ! ## [Watchtower](https://watchtower.nickfedor.com/), pour mettre à jour les conteneurs automatiquement -Watchtower est un conteneur qui permet de vérifier les mise à jour et d'installer les nouvelles images sans effort, en ajoutant un simple label dans les fichiers `compose.yml` de vos conteneurs. +Watchtower est un conteneur qui permet de vérifier les mise à jour et d'installer les nouvelles images sans effort, en ajoutant un simple label dans les fichiers `compose.yaml` de vos conteneurs. ### Configuration @@ -178,7 +178,7 @@ WH_URL= #### Activer Watchtower sur les autres conteneurs -Pour que Watchtower surveille vos autres conteneurs, ajoutez ceci à leur `compose.yml` : +Pour que Watchtower surveille vos autres conteneurs, ajoutez ceci à leur `compose.yaml` : ```yaml [compose.yaml] --- diff --git a/content/fr/3.serveex/2.core/4.swag.md b/content/fr/3.serveex/2.core/4.swag.md index 456d4c8..1fc1eab 100644 --- a/content/fr/3.serveex/2.core/4.swag.md +++ b/content/fr/3.serveex/2.core/4.swag.md @@ -42,7 +42,7 @@ tree: - nginx.conf - proxy-confs: - dockge.subdomain.conf - - compose.yml + - compose.yaml - .env --- :: @@ -348,7 +348,7 @@ Enregistrez et quittez. La configuration se met à jour en quelques secondes. ::note -Par défaut, SWAG ne connaît pas le nom « dockge ». Vous devrez ajouter le réseau de Dockge au `compose.yml` de SWAG. +Par défaut, SWAG ne connaît pas le nom « dockge ». Vous devrez ajouter le réseau de Dockge au `compose.yaml` de SWAG. :: ### Ajouter le réseau de Dockge à SWAG @@ -398,7 +398,7 @@ sudo cp nomduservice.subdomain.conf.sample nomduservice.subdomain.conf __Si le sous-domaine n'est pas redirigé correctement__ - Ouvrez le fichier et vérifiez le nom du conteneur dans `set $upstream_app nomduconteneur;`{lang=nginx} -- Assurez-vous d'avoir ajouté le réseau du conteneur dans le `compose.yml` de SWAG +- Assurez-vous d'avoir ajouté le réseau du conteneur dans le `compose.yaml` de SWAG :: Vous pouvez aussi personnaliser le sous-domaine en modifiant `server_name votresousdomaine.*;`{lang=nginx} et en renommant le fichier en `votresousdomaine.subdomain.conf`. diff --git a/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md b/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md index 54f5d76..8a084f4 100644 --- a/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md +++ b/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md @@ -165,7 +165,7 @@ Enregistrez et quittez. La configuration se met à jour en quelques secondes. ::note -Par défaut, SWAG ne connaît pas le nom « speedtest-tracker ». Pour autoriser l'accès, vous devez ajouter le réseau de Speedtest Tracker au `compose.yml` de SWAG. +Par défaut, SWAG ne connaît pas le nom « speedtest-tracker ». Pour autoriser l'accès, vous devez ajouter le réseau de Speedtest Tracker au `compose.yaml` de SWAG. :: Allez dans Dockge et modifiez le compose de SWAG pour y inclure le réseau de Speedtest Tracker : -- 2.54.0 From 2b67ba44614cad9093aefc5df3ab1afe9dac85e4 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:09:58 +0200 Subject: [PATCH 04/20] Fix the /boot partition inconsistency across three pages --- content/en/2.general/5.linux/2.filesystem.md | 4 ++-- content/en/3.serveex/2.core/1.installation.md | 2 +- content/fr/2.general/5.linux/2.filesystem.md | 4 ++-- content/fr/3.serveex/2.core/1.installation.md | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/en/2.general/5.linux/2.filesystem.md b/content/en/2.general/5.linux/2.filesystem.md index 5f37d6d..3e2288e 100644 --- a/content/en/2.general/5.linux/2.filesystem.md +++ b/content/en/2.general/5.linux/2.filesystem.md @@ -22,13 +22,13 @@ That tree isn't arbitrary either. Every Debian install has the same folders in t | `/usr` | The installed programs themselves, managed by `apt` | | `/opt` | Software installed outside the package manager | | `/mnt` and `/media` | Where extra disks get mounted, `/media` for removable ones | -| `/boot` | The kernel and the bootloader, on a small partition of its own | +| `/boot` | The kernel and the bootloader. On a default UEFI Debian install it lives on `/`; only `/boot/efi` (the EFI system partition) is separate | | `/dev` | Your hardware, exposed as files (`/dev/sda` is a disk) | | `/proc` and `/sys` | The kernel's live state, invented on the fly, not real files | ## Folders are not partitions -Partitions are a different question from folders. A minimal Debian install typically creates two, one for `/` and one for swap, so every folder above except `/boot` lives on the same partition and shares the same free space. Two commands to see the reality of it: `lsblk` draws the tree of disks and partitions, `df -h` shows how full each one is. +Partitions are a different question from folders. A minimal Debian install typically creates two, one for `/` and one for swap, so every folder above except `/boot/efi` lives on the same partition and shares the same free space. Two commands to see the reality of it: `lsblk` draws the tree of disks and partitions, `df -h` shows how full each one is. ```bash [Terminal] lsblk diff --git a/content/en/3.serveex/2.core/1.installation.md b/content/en/3.serveex/2.core/1.installation.md index 822b59c..379e8de 100644 --- a/content/en/3.serveex/2.core/1.installation.md +++ b/content/en/3.serveex/2.core/1.installation.md @@ -311,7 +311,7 @@ sudo apt full-upgrade sudo apt autoremove --purge ``` -Every kernel update leaves the previous one installed, and `/boot` is a small partition that eventually fills up and breaks the next upgrade. Do this every single time, not once in a while. `--purge` also drops the config files of the packages being removed. +Every kernel update leaves the previous one installed, and they pile up if nobody clears them out. Do this every single time, not once in a while. `--purge` also drops the config files of the packages being removed. #### Reboot if the kernel moved diff --git a/content/fr/2.general/5.linux/2.filesystem.md b/content/fr/2.general/5.linux/2.filesystem.md index 83418a0..3fc2fbe 100644 --- a/content/fr/2.general/5.linux/2.filesystem.md +++ b/content/fr/2.general/5.linux/2.filesystem.md @@ -22,13 +22,13 @@ Cet arborescence n'a rien d'arbitraire. Toutes les installations de Debian sont | `/usr` | Les programmes installés eux-mêmes, gérés par `apt` | | `/opt` | Les logiciels installés en dehors du gestionnaire de paquets | | `/mnt` et `/media` | Là où sont montés les disques supplémentaires, `/media` pour les amovibles | -| `/boot` | Le noyau et le chargeur de démarrage, sur une petite partition à part | +| `/boot` | Le noyau et le chargeur de démarrage. Sur une install Debian UEFI par défaut, il vit sur `/` ; seule `/boot/efi` (la partition système EFI) est à part | | `/dev` | Votre matériel, exposé sous forme de fichiers (`/dev/sda` est un disque) | | `/proc` et `/sys` | L'état vivant du noyau, changeant à la volée, pas de vrais fichiers | ## Un dossier n'est pas une partition -Les partitions sont une question distincte des dossiers. Une installation minimale de Debian en crée typiquement deux, une pour `/` et une pour le swap, si bien que tous les dossiers ci-dessus sauf `/boot` vivent sur la même partition et se partagent le même espace libre. Deux commandes pour en voir la réalité : `lsblk` dessine l'arbre des disques et des partitions, `df -h` montre le taux de remplissage de chacune. +Les partitions sont une question distincte des dossiers. Une installation minimale de Debian en crée typiquement deux, une pour `/` et une pour le swap, si bien que tous les dossiers ci-dessus sauf `/boot/efi` vivent sur la même partition et se partagent le même espace libre. Deux commandes pour en voir la réalité : `lsblk` dessine l'arbre des disques et des partitions, `df -h` montre le taux de remplissage de chacune. ```bash [Terminal] lsblk diff --git a/content/fr/3.serveex/2.core/1.installation.md b/content/fr/3.serveex/2.core/1.installation.md index 68f0dba..0689f60 100644 --- a/content/fr/3.serveex/2.core/1.installation.md +++ b/content/fr/3.serveex/2.core/1.installation.md @@ -312,7 +312,7 @@ sudo apt full-upgrade sudo apt autoremove --purge ``` -Chaque mise à jour de noyau laisse le précédent installé, et `/boot` est une petite partition qui finit par se remplir et casser la mise à jour suivante. Faites-le à chaque fois, pas de temps en temps. `--purge` supprime aussi les fichiers de configuration des paquets retirés. +Chaque mise à jour de noyau laisse le précédent installé, et ça s'accumule si personne ne fait le ménage. Faites-le à chaque fois, pas de temps en temps. `--purge` supprime aussi les fichiers de configuration des paquets retirés. #### Redémarrer si le noyau a bougé -- 2.54.0 From 9af6ba21b9aeb20cfbf7cf2f27081ac1d6fe1a2c Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:10:08 +0200 Subject: [PATCH 05/20] Fix heading hierarchy in the hardware basics article --- content/en/2.general/4.hardware/1.basics.md | 12 ++++++------ content/fr/2.general/4.hardware/1.basics.md | 12 ++++++------ 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/content/en/2.general/4.hardware/1.basics.md b/content/en/2.general/4.hardware/1.basics.md index 87fce34..4b978c0 100644 --- a/content/en/2.general/4.hardware/1.basics.md +++ b/content/en/2.general/4.hardware/1.basics.md @@ -64,7 +64,7 @@ The __GPU__ (Graphics Processing Unit) handles graphical, video, and sometimes A Depending on the required performance, one can choose between a dedicated GPU with its own VRAM (a graphics card connected to a PCIe slot on the motherboard), or an iGPU, an integrated GPU built into the CPU (such as the N100/N150 or N305/N355), which uses the system’s shared RAM. -### HDD(s) +## HDD(s)

Image @@ -82,7 +82,7 @@ Generally, HDDs are best suited for storing data that doesn’t require frequent Comes in 3.5" and 2.5" formats; servers usually favor the more reliable 3.5". -### SSD(s) +## SSD(s)

Image @@ -96,7 +96,7 @@ SSDs come in various formats, but today the preferred choice is the M.2 NVMe ver However, SSDs are significantly more expensive than hard drives for the same storage capacity. Typically, the operating system (OS) is installed on the SSD to ensure fast performance. In a server environment, it's also ideal to store [Docker containers](/serveex/core/docker) and databases on the SSD. More broadly, any data that needs to be accessed frequently and quickly, such as websites, applications, or processing workloads, should be stored on an SSD. -### Network Card +## Network Card A __network card__ allows your machine to communicate with your network (including the internet). It consists of a controller chip and one or more network ports. These ports, often Ethernet ports, can come in different physical formats and support various data transfer standards: @@ -116,7 +116,7 @@ The network card is usually built directly into the motherboard, but you can als In general, for a server setup, it's recommended to have at least two Ethernet ports to ensure redundancy in case one connection fails. -### Input/Output Ports +## Input/Output Ports __I/O__ ports allow communication with external devices (displays, keyboard, mouse, network...). Motherboards typically offer: @@ -127,7 +127,7 @@ __I/O__ ports allow communication with external devices (displays, keyboard, mou Choose a motherboard and expansions based on your I/O needs. -### Power Supply +## Power Supply The __power supply unit__ (PSU) is the component that provides electrical power to your machine’s components. It connects to the wall via a power cord and has several output cables that plug into the motherboard and various peripherals, such as hard drives or dedicated graphics cards. @@ -141,7 +141,7 @@ Another important factor is the form factor. There are several standard sizes, f To choose the right PSU, a common rule of thumb is to estimate your system’s power needs based on usage, and then double that value. This is because most power supplies operate at optimal efficiency around 50% of their maximum load. -### Case +## Case

Image diff --git a/content/fr/2.general/4.hardware/1.basics.md b/content/fr/2.general/4.hardware/1.basics.md index 50b2728..5264751 100644 --- a/content/fr/2.general/4.hardware/1.basics.md +++ b/content/fr/2.general/4.hardware/1.basics.md @@ -64,7 +64,7 @@ Le __GPU__ (Graphical Processor Unit) est un processeur dédié aux calculs grap Selon la puissance requise, on choisira un GPU dédié avec sa propre VRAM (une carte graphique à brancher sur un port PCIe de la carte mère), ou un iGPU, c'est à dire un GPU compris dans le CPU (comme les N100/N150 et N305/N355), qui utilisera la RAM globale de la machine -### Le ou les HDD +## Le ou les HDD

Image @@ -82,7 +82,7 @@ De manière générale, on les privilégiera pour stocker des données qui ne se Il existe plusieurs formats de HDD : 3.5" et 2.5". De manière générale dans un serveur on privilégiera les 3.5, plus fiables. -### Le ou les SSD +## Le ou les SSD

Image @@ -96,7 +96,7 @@ On les trouve dans plusieurs formats, aujourd'hui on priviligiera les versions M Ils sont en revanche beaucoup plus chers que les disque durs à capacité de stockage égale. Généralement, on y stockera au moins le système d'exploitation de la machine (Operating System ou OS) pour garantir une certaine rapidité d'execution. Dans le cadre d'un serveur, on y stockera aussi si possible les conteneurs type [docker](/serveex/core/docker) et les bases de données. De manière générale, toute données dont un a besoin régulièrement et rapidement pour des calculs (site web, applications, etc...). -### La carte réseau +## La carte réseau Une __carte réseau__ sert à faire communiquer votre machine avec votre réseau (dont internet). Elle est composée d'une puce de controle et d'un ou plusieurs port réseau. Ces ports peuvent dits _ports ethernet_ peuvent être dans plusieurs formats physique et dans plusieurs normes de débit : @@ -116,7 +116,7 @@ La carte réseau est généralement directement intégrée à la carte mère, ma De manière générale, sur un serveur, on appréciera d'avoir au moins deux ports ethernet afin d'avoir de la redondance en cas de panne. -### Entrées et sorties +## Entrées et sorties Les __ports d'entrées et sorties__ (I/O) permettent de communiquer avec des appareils externes (écrans, clavier, souris, réseau...). Sur une carte mère, on trouve généralement : @@ -127,7 +127,7 @@ Les __ports d'entrées et sorties__ (I/O) permettent de communiquer avec des app Choisissez votre carte mère et ses cartes d'extension en fonction de vos besoins en I/O. -### L'alimentation +## L'alimentation __L'alimentation__ est le composant qui fournit l'énergie électrique aux composants de votre machine. Elle se branche au secteur par un cordon et dispose de plusieurs câbles de sortie qui vont sur la carte mère et sur divers périphériques, comme les disques durs ou les cartes graphiques dédiées. @@ -141,7 +141,7 @@ Un autre facteur important est le format. Il en existe plusieurs standard, comme Pour choisir votre alimentation, la convention est d'estimer la puissance electrique demandée par votre machine à usage et de multiplier par deux cette puissance. En effet, le rendement des alimentations se situe environ à 50% de sa charge totale. -### Le boitier +## Le boitier

Image -- 2.54.0 From 485c5d55785d650db5fb55a26d5b6c48de7592be Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:10:29 +0200 Subject: [PATCH 06/20] Replace the nonexistent ::info admonition with ::note --- content/fr/2.general/5.linux/1.cli-basics.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/fr/2.general/5.linux/1.cli-basics.md b/content/fr/2.general/5.linux/1.cli-basics.md index 83672e6..ae3669f 100644 --- a/content/fr/2.general/5.linux/1.cli-basics.md +++ b/content/fr/2.general/5.linux/1.cli-basics.md @@ -49,8 +49,8 @@ Quand la cible est un endroit sur le disque, vous l'écrivez sous forme de chemi | `/var/log` | un chemin **absolu**, même résultat depuis n'importe où | | `logs/aujourdhui` | un chemin **relatif**, compris depuis là où vous êtes | -::info -L'usage des dossiers par l'OS est un sujet à part entière, traité dans [dossiers et partitions](/general/linux/filesystem). +::note{to="/general/linux/filesystem"} +L'usage des dossiers par l'OS est un sujet à part entière, traité dans **dossiers et partitions**. :: L'invite de commande indique elle-même où vous êtes : dans `utilisateur@serveex:~/docker$`, vous êtes connecté en tant qu'`utilisateur` sur la machine nommée `serveex`, dans le dossier `docker` de votre home. Ce `$` final signifie que vous êtes loggé avec un utilisateur normal. Si vous voyez `#` à la place, c'est que vous êtes connecté avec l'utilisateur root et chaque faute de frappe compte double. -- 2.54.0 From 5548287c65386fc9ad1344b76377388b0022a6ed Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:42:30 +0200 Subject: [PATCH 07/20] Fix 10 Mbit/s conversion error and DNS zone example inconsistencies --- content/en/2.general/2.networking/2.dns.md | 11 ++++++----- content/en/2.general/4.hardware/1.basics.md | 2 +- content/en/2.general/4.hardware/2.network.md | 2 +- content/fr/2.general/2.networking/2.dns.md | 13 +++++++------ content/fr/2.general/4.hardware/1.basics.md | 2 +- content/fr/2.general/4.hardware/2.network.md | 2 +- 6 files changed, 17 insertions(+), 15 deletions(-) diff --git a/content/en/2.general/2.networking/2.dns.md b/content/en/2.general/2.networking/2.dns.md index 585d573..2becd81 100644 --- a/content/en/2.general/2.networking/2.dns.md +++ b/content/en/2.general/2.networking/2.dns.md @@ -23,12 +23,13 @@ You can enter _records_ into this DNS zone to direct requests properly. You can Example of a DNS zone for the domain `mydomain.com`: ``` +$TTL 3600 @ IN SOA ns1.dns.me. dns.net. (2024051800 86400 3600 3600000 60) IN NS ns1.dns.me. IN NS ns2.dns.me. - IN A 203.0.113.0 -www IN CNAME mydomain.com -sousdomaine IN CNAME mydomain.com + IN A 203.0.113.10 +www IN CNAME mydomain.com. +subdomain IN CNAME mydomain.com. ``` In this example: @@ -36,8 +37,8 @@ In this example: - `$TTL 3600` tells global name servers that the records are valid for 1 hour (after which they need to re-check). - `IN SOA ns1.dns.me. dns.net. (...)` indicates `ns1.dns.me` as the primary DNS server, with refresh intervals. - `IN NS` records define the authoritative name servers for the domain. -- `IN A 203.0.113.0` means `mydomain.com` points to IP `203.0.113.0`. -- `subdomain IN CNAME mydomain.com` means `subdomain.mydomain.com` points to the same destination as `mydomain.com`. +- `IN A 203.0.113.10` means `mydomain.com` points to IP `203.0.113.10`. +- `subdomain IN CNAME mydomain.com.` means `subdomain.mydomain.com` points to the same destination as `mydomain.com`. So, if you want to point `mydomain.com` to your server, you can do it by adding an `A` record pointing to your server's public IP address. diff --git a/content/en/2.general/4.hardware/1.basics.md b/content/en/2.general/4.hardware/1.basics.md index 4b978c0..93de99c 100644 --- a/content/en/2.general/4.hardware/1.basics.md +++ b/content/en/2.general/4.hardware/1.basics.md @@ -100,7 +100,7 @@ However, SSDs are significantly more expensive than hard drives for the same sto A __network card__ allows your machine to communicate with your network (including the internet). It consists of a controller chip and one or more network ports. These ports, often Ethernet ports, can come in different physical formats and support various data transfer standards: -- __RJ45 Gigabit Ethernet (10/100/1000):__ The standard RJ45 connector, supporting speeds from 10 Mbps (0.125 MB/s) up to 1000 Mbps (125 MB/s). +- __RJ45 Gigabit Ethernet (10/100/1000):__ The standard RJ45 connector, supporting speeds from 10 Mbps (1.25 MB/s) up to 1000 Mbps (125 MB/s). - __RJ45 2.5G:__ Same connector type, supporting up to 2.5 Gbps (2,500 Mbps or 312.5 MB/s). - __RJ45 5G:__ Same connector, supporting up to 5 Gbps (625 MB/s). - __RJ45 10G Base-T:__ Same RJ45 format, supporting up to 10 Gbps (1.25 GB/s). diff --git a/content/en/2.general/4.hardware/2.network.md b/content/en/2.general/4.hardware/2.network.md index ac1ff7a..8dae9a5 100644 --- a/content/en/2.general/4.hardware/2.network.md +++ b/content/en/2.general/4.hardware/2.network.md @@ -52,7 +52,7 @@ Cables are essential components of your network. Depending on their type and cat Here’s a quick reference of the most common cable and port standards: -- **RJ45 Gigabit Ethernet 10/100/1000**: The standard RJ45 connector, supporting speeds from 10 Mbps (0.125 MB/s) to 1000 Mbps (125 MB/s) +- **RJ45 Gigabit Ethernet 10/100/1000**: The standard RJ45 connector, supporting speeds from 10 Mbps (1.25 MB/s) to 1000 Mbps (125 MB/s) - **RJ45 2.5G**: Same connector, supporting speeds up to 2.5 Gbps (312.5 MB/s) - **RJ45 5G**: Same connector, supporting speeds up to 5 Gbps (625 MB/s) - **RJ45 10GBase-T**: Same connector, supporting speeds up to 10 Gbps (1.25 GB/s) diff --git a/content/fr/2.general/2.networking/2.dns.md b/content/fr/2.general/2.networking/2.dns.md index b62a1e4..19fcb25 100644 --- a/content/fr/2.general/2.networking/2.dns.md +++ b/content/fr/2.general/2.networking/2.dns.md @@ -23,21 +23,22 @@ Vous pouvez rentrer des _enregistrements_ dans cette zone DNS qui permettront d' Exemple d'une zone DNS du domaine mondomaine.fr: ``` +$TTL 3600 @ IN SOA ns1.dns.me. dns.net. (2024051800 86400 3600 3600000 60) IN NS ns1.dns.me. IN NS ns2.dns.me. - IN A 203.0.113.0 -www IN CNAME mondomaine.fr -sousdomaine IN CNAME mondomaine.fr + IN A 203.0.113.10 +www IN CNAME mondomaine.fr. +sousdomaine IN CNAME mondomaine.fr. ``` Dans cet exemple : -- `$TTL 3600` indique aux différents serveurs de noms de la planète que les enregistrement sont valides 1h (et qu'au-delà il faudra rev"rifier). +- `$TTL 3600` indique aux différents serveurs de noms de la planète que les enregistrements sont valides 1h (et qu'au-delà il faudra revérifier). - `IN SOA ns1.dns.me. dns.net. (2024051800 86400 3600 3600000 60)` indique que `ns1.dns.me` est le serveur dns principal, et les nombres sont des indications de rafraichissement. - `IN NS ns1.dns.me.` et `IN NS ns2.dns.me.` indique que `ns1.dns.me` et `ns2.dns.me` sont des serveurs de noms pour ce domaine. -- `IN A 203.0.113.0` signifie que `mondomaine.fr` pointe vers l'IP `203.0.113.0` -- `sousdomaine IN CNAME mondomaine.fr` signifie que `sousdomaine.mondomaine.fr` pointe vers `mondomaine.fr` et donc vers l'IP `203.0.113.0`. +- `IN A 203.0.113.10` signifie que `mondomaine.fr` pointe vers l'IP `203.0.113.10` +- `sousdomaine IN CNAME mondomaine.fr.` signifie que `sousdomaine.mondomaine.fr` pointe vers `mondomaine.fr` et donc vers l'IP `203.0.113.10`. Ainsi, si vous choisissez de pointer le domaine `mondomaine.fr` vers votre serveur, vous pouvez le faire en ajoutant un enregistrement `A` pointant vers l'IP publique de votre serveur. diff --git a/content/fr/2.general/4.hardware/1.basics.md b/content/fr/2.general/4.hardware/1.basics.md index 5264751..0a362c4 100644 --- a/content/fr/2.general/4.hardware/1.basics.md +++ b/content/fr/2.general/4.hardware/1.basics.md @@ -100,7 +100,7 @@ Ils sont en revanche beaucoup plus chers que les disque durs à capacité de sto Une __carte réseau__ sert à faire communiquer votre machine avec votre réseau (dont internet). Elle est composée d'une puce de controle et d'un ou plusieurs port réseau. Ces ports peuvent dits _ports ethernet_ peuvent être dans plusieurs formats physique et dans plusieurs normes de débit : -- RJ45 Gigabit ethernet 10/100/1000 : le format standard de prise RJ45 permettant de dialoguer à des débit allant de 10Mbps (soit 0,125Mo/s) à 1000Mbps (soit 125Mo/s) +- RJ45 Gigabit ethernet 10/100/1000 : le format standard de prise RJ45 permettant de dialoguer à des débit allant de 10Mbps (soit 1,25Mo/s) à 1000Mbps (soit 125Mo/s) - RJ45 2.5G : Même prise, pouvant dialoguer jusqu'à 2,5Gpbs soit 2 500Mbps (donc 312,5Mo/s) - RJ45 5G : Même prise, pouvant dialoguer jusqu'à 5Gpbs (donc 625Mo/s) - RJ45 10G Base T : Même prise pouvant dialoguer jusqu'à 10Gbs (soit 1,25Go/s) diff --git a/content/fr/2.general/4.hardware/2.network.md b/content/fr/2.general/4.hardware/2.network.md index 40131b8..0bc04f1 100644 --- a/content/fr/2.general/4.hardware/2.network.md +++ b/content/fr/2.general/4.hardware/2.network.md @@ -52,7 +52,7 @@ Les cables sont des composants essentiels de votre réseau. Selon leur type et c Voici un rappel des normes de cables et de ports les plus courantes : -- **RJ45 Gigabit Ethernet 10/100/1000** : le format standard de prise RJ45 permettant de dialoguer à des débit allant de 10Mbps (soit 0,125Mo/s) à 1000Mbps (soit 125Mo/s) +- **RJ45 Gigabit Ethernet 10/100/1000** : le format standard de prise RJ45 permettant de dialoguer à des débit allant de 10Mbps (soit 1,25Mo/s) à 1000Mbps (soit 125Mo/s) - **RJ45 2.5G** : Même prise, pouvant dialoguer jusqu'à 2,5Gpbs soit 2 500Mbps (donc 312,5Mo/s) - **RJ45 5G** : Même prise, pouvant dialoguer jusqu'à 5Gpbs (donc 625Mo/s) - **RJ45 10GBase-T** : Même prise pouvant dialoguer jusqu'à 10Gb/s (soit 1,25Go/s) -- 2.54.0 From 81c54c9afca901e8eece05f7d9ee7e11ca8be349 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:42:40 +0200 Subject: [PATCH 08/20] Put Docker Socket Proxy in front of every container that needs the Docker API instead of mounting docker.sock directly --- content/en/3.serveex/2.core/2.docker.md | 81 ++++++++++++++++++- content/en/3.serveex/4.monitoring/2.dozzle.md | 33 +++++++- content/en/3.serveex/4.monitoring/4.beszel.md | 45 ++++++++++- .../en/3.serveex/91.advanced/1.authentik.md | 50 ++++++++++-- content/en/3.serveex/91.advanced/2.arcane.md | 4 +- content/fr/3.serveex/2.core/2.docker.md | 81 ++++++++++++++++++- content/fr/3.serveex/4.monitoring/2.dozzle.md | 39 ++++++++- content/fr/3.serveex/4.monitoring/4.beszel.md | 51 ++++++++++-- .../fr/3.serveex/91.advanced/1.authentik.md | 57 ++++++++++--- content/fr/3.serveex/91.advanced/2.arcane.md | 6 +- 10 files changed, 401 insertions(+), 46 deletions(-) diff --git a/content/en/3.serveex/2.core/2.docker.md b/content/en/3.serveex/2.core/2.docker.md index 5830839..84cbba7 100644 --- a/content/en/3.serveex/2.core/2.docker.md +++ b/content/en/3.serveex/2.core/2.docker.md @@ -94,15 +94,52 @@ services: container_name: dockge ports: - 3555:5001 # LAN-accessible port will be 3555 - + environment: + - DOCKER_HOST=tcp://docker-socket-proxy:2375 + - DOCKGE_STACKS_DIR=/srv/docker volumes: - - /var/run/docker.sock:/var/run/docker.sock - /srv/docker/dockge/data:/app/data - /srv/docker:/srv/docker + networks: + - dockge-internal + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-dockge + security_opt: + - no-new-privileges:true + networks: + - dockge-internal + volumes: + - /var/run/docker.sock:/var/run/docker.sock:ro environment: - - DOCKGE_STACKS_DIR=/srv/docker + - CONTAINERS=1 + - IMAGES=1 + - NETWORKS=1 + - VOLUMES=1 + - EXEC=1 + - INFO=1 + - SYSTEM=1 + - POST=1 + - ALLOW_START=1 + - ALLOW_STOP=1 + - ALLOW_RESTARTS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run + +networks: + dockge-internal: + name: dockge-internal ``` +::warning +Dockge needs access to the Docker API to manage every other stack on this server, which is effectively root access to your host. Instead of mounting `/var/run/docker.sock` directly, this config sits **Docker Socket Proxy** in front of it, only allowing the specific permissions Dockge needs (containers, images, networks, volumes, exec, lifecycle actions), on their own internal network. Dockge has no built-in login by default, so never expose port `3555` beyond your LAN without putting it behind [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik) first. +:: + Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. #### Launch the container @@ -149,12 +186,44 @@ services: - WATCHTOWER_LABEL_ENABLE=true - WATCHTOWER_CLEANUP=true - WATCHTOWER_REMOVE_VOLUMES=true + - DOCKER_HOST=tcp://docker-socket-proxy:2375 # Discord notifications - uncomment if used #- WATCHTOWER_NOTIFICATIONS=slack #- WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER=Watchtower #- WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL=${WH_URL} + networks: + - watchtower-internal + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-watchtower + security_opt: + - no-new-privileges:true + networks: + - watchtower-internal volumes: - - /var/run/docker.sock:/var/run/docker.sock + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + - IMAGES=1 + - NETWORKS=1 + - VOLUMES=1 + - INFO=1 + - SYSTEM=1 + - POST=1 + - ALLOW_START=1 + - ALLOW_STOP=1 + - ALLOW_RESTARTS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run + +networks: + watchtower-internal: + name: watchtower-internal ``` ::warning @@ -162,6 +231,10 @@ services: `WATCHTOWER_REMOVE_VOLUMES=true` deletes a container's anonymous volumes as soon as it's updated. Combined with a `latest` tag, an automatic update can silently wipe data for any app that still stores something in an anonymous (unnamed) volume instead of a bind mount. :: +::note +This config sits **Docker Socket Proxy** in front of the Docker API instead of mounting `/var/run/docker.sock` directly, so Watchtower only gets the permissions it actually needs (list/pull images, recreate containers) rather than full root-equivalent access to the host. +:: + #### Set your environment variables Fill in the `.env` section in Dockge with the following: diff --git a/content/en/3.serveex/4.monitoring/2.dozzle.md b/content/en/3.serveex/4.monitoring/2.dozzle.md index 579fa9f..77c227c 100644 --- a/content/en/3.serveex/4.monitoring/2.dozzle.md +++ b/content/en/3.serveex/4.monitoring/2.dozzle.md @@ -43,10 +43,41 @@ services: - .env environment: - DOZZLE_HOSTNAME=${DOMAIN} + - DOCKER_HOST=tcp://docker-socket-proxy:2375 + networks: + - dozzle-internal + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-dozzle + security_opt: + - no-new-privileges:true + networks: + - dozzle-internal volumes: - - /var/run/docker.sock:/var/run/docker.sock + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + - IMAGES=1 + - INFO=1 + - EVENTS=1 + - ALLOW_LOGS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run + +networks: + dozzle-internal: + name: dozzle-internal ``` +::note +Dozzle only ever reads container logs, so this config sits **Docker Socket Proxy** in front of the Docker API instead of mounting `/var/run/docker.sock` directly, keeping `POST` disabled entirely: Dozzle can list containers and stream their logs, and nothing else. +:: + ::tip{icon=""} ✨ __Tip:__ Add the watchtower label to each container to automate updates diff --git a/content/en/3.serveex/4.monitoring/4.beszel.md b/content/en/3.serveex/4.monitoring/4.beszel.md index e1b6ea5..b97ba90 100644 --- a/content/en/3.serveex/4.monitoring/4.beszel.md +++ b/content/en/3.serveex/4.monitoring/4.beszel.md @@ -53,13 +53,35 @@ services: network_mode: host volumes: - ./socket:/beszel_socket - - /var/run/docker.sock:/var/run/docker.sock:ro environment: LISTEN: /beszel_socket/beszel.sock + DOCKER_HOST: tcp://127.0.0.1:2375 # Do not remove quotes around the key KEY: ${KEY} + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-beszel + security_opt: + - no-new-privileges:true + ports: + - 127.0.0.1:2375:2375 + volumes: + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run ``` +::note +`beszel-agent` runs with `network_mode: host`, so it can't join a dedicated internal network like the other proxied stacks on this site; instead, **Docker Socket Proxy** publishes its API on `127.0.0.1` only, reachable from the agent via the host's own loopback interface, with just `CONTAINERS=1` enabled since the agent only needs to read container stats. +:: + ::tip{icon=""} ✨ __Tip:__ Add the Watchtower label to each container to automate updates. @@ -122,11 +144,28 @@ services: container_name: beszel-agent restart: unless-stopped network_mode: host - volumes: - - /var/run/docker.sock:/var/run/docker.sock:ro environment: LISTEN: ${PORT} KEY: ${KEY} + DOCKER_HOST: tcp://127.0.0.1:2375 + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-beszel + security_opt: + - no-new-privileges:true + ports: + - 127.0.0.1:2375:2375 + volumes: + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run ``` And in `.env`: diff --git a/content/en/3.serveex/91.advanced/1.authentik.md b/content/en/3.serveex/91.advanced/1.authentik.md index 7e1f7a1..99d2484 100644 --- a/content/en/3.serveex/91.advanced/1.authentik.md +++ b/content/en/3.serveex/91.advanced/1.authentik.md @@ -19,7 +19,7 @@ Authentik also supports multi-factor authentication, including TOTP (a code gene It's a great alternative to VPNs for securely exposing services, especially ones that lack MFA or login protection (e.g., the SWAG dashboard). -Authentik has [extensive documentation](https://docs.goauthentik.io/docs/installation/docker-compose) and [great tutorials from Cooptonian](https://www.youtube.com/@cooptonian). Here, we’ll cover the basics using Dockge as an example. +Authentik has [extensive documentation](https://docs.goauthentik.io/install-config/install/docker-compose) and [great tutorials from Cooptonian](https://www.youtube.com/@cooptonian). Here, we’ll cover the basics using Dockge as an example. There are two main modes you should know: @@ -156,24 +156,54 @@ services: AUTHENTIK_POSTGRESQL__USER: ${PG_USER:-authentik} AUTHENTIK_POSTGRESQL__NAME: ${PG_DB:-authentik} AUTHENTIK_POSTGRESQL__PASSWORD: ${PG_PASS} - # `user: root` and the docker socket volume are optional. - # See more for the docker socket integration here: + # `user: root` and the Docker integration below are optional, only needed if you + # want Authentik to auto-manage embedded outposts on this host. See: # https://goauthentik.io/docs/outposts/integrations/docker # Removing `user: root` also prevents the worker from fixing the permissions # on the mounted folders, so when removing this make sure the folders have the correct UID/GID # (1000:1000 by default) user: root volumes: - - /var/run/docker.sock:/var/run/docker.sock - ./media:/media - ./certs:/certs - ./custom-templates:/templates - ./ssh:/authentik/.ssh + networks: + - default + - authentik-internal env_file: - .env depends_on: - postgresql - redis + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-authentik + security_opt: + - no-new-privileges:true + networks: + - authentik-internal + volumes: + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + - IMAGES=1 + - NETWORKS=1 + - INFO=1 + - POST=1 + - ALLOW_START=1 + - ALLOW_STOP=1 + - ALLOW_RESTARTS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run + +networks: + authentik-internal: + name: authentik-internal volumes: database: @@ -182,6 +212,10 @@ volumes: driver: local ``` +::note +This adds **Docker Socket Proxy** so the optional Docker integration never needs `/var/run/docker.sock` mounted directly into the worker. If you enable it, set the connection's Docker URL in the admin UI to `http://docker-socket-proxy:2375` instead of the local socket path, as [Authentik's own docs recommend](https://goauthentik.io/docs/outposts/integrations/docker) for socket-proxy setups. +:: + ### Begin the initial setup In the `.env` file, the `PG_PASS` and `AUTHENTIK_SECRET_KEY` variables are already set. @@ -322,7 +356,7 @@ Go to _Settings_, click the _MFA_ section, then _Register_. Choose a method like You’ll now be prompted to enter a one-time code at every login. ## Protecting a Native App -Authentik is natively compatible with several applications. You can find the list and [support here](https://docs.goauthentik.io/integrations/services/). +Authentik is natively compatible with several applications. You can find the list and [support here](https://integrations.goauthentik.io/). ## Protecting an App via Reverse Proxy SWAG lets you insert Authentik’s login page between a request and access to your service. To do this: @@ -436,9 +470,9 @@ We assume you’ve already installed [Docker](/serveex/core/docker) and [SWAG](/ ### Create the stack folder -On your remote machine, use [Dockge](/serveex/core/docker/#installer-dockge-pour-gérer-et-déployer-les-conteneurs) to create a stack named `authentik-outpost`. +On your remote machine, use [Dockge](/serveex/core/docker/#install-dockge-to-manage-and-deploy-containers) to create a stack named `authentik-outpost`. -If you haven’t installed [Dockge](/serveex/core/docker/#installer-dockge-pour-gérer-et-déployer-les-conteneurs), create a folder `/srv/docker/authentik-outpost`, or directly via command line: +If you haven’t installed [Dockge](/serveex/core/docker/#install-dockge-to-manage-and-deploy-containers), create a folder `/srv/docker/authentik-outpost`, or directly via command line: ```bash [Terminal] sudo mkdir -P /srv/docker/authentik-outpost @@ -515,7 +549,7 @@ We assume the Dockge network name is `authentik-outpost_default`. ### Restart SWAG -If using [Dockge](/serveex/core/docker/#installer-dockge-pour-gérer-et-déployer-les-conteneurs), restart SWAG. +If using [Dockge](/serveex/core/docker/#install-dockge-to-manage-and-deploy-containers), restart SWAG. Otherwise, via terminal: diff --git a/content/en/3.serveex/91.advanced/2.arcane.md b/content/en/3.serveex/91.advanced/2.arcane.md index 96000ac..8f5b29c 100644 --- a/content/en/3.serveex/91.advanced/2.arcane.md +++ b/content/en/3.serveex/91.advanced/2.arcane.md @@ -6,7 +6,7 @@ description: Install Arcane, a modern Docker and Compose management web UI, as a :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -::note{to="/serveex/core/docker#installer-dockge-pour-gérer-et-déployer-les-conteneurs"} +::note{to="/serveex/core/docker#install-dockge-to-manage-and-deploy-containers"} This is an advanced alternative to **Dockge**: it can manage several remote Docker hosts from a single instance, and supports OIDC login natively instead of relying on a separate forward-auth proxy. :: @@ -72,7 +72,7 @@ services: docker-socket-proxy: image: lscr.io/linuxserver/socket-proxy:latest - container_name: arcane-docker-proxy + container_name: docker-socket-proxy-arcane security_opt: - no-new-privileges:true networks: diff --git a/content/fr/3.serveex/2.core/2.docker.md b/content/fr/3.serveex/2.core/2.docker.md index 43ca15f..4a23736 100644 --- a/content/fr/3.serveex/2.core/2.docker.md +++ b/content/fr/3.serveex/2.core/2.docker.md @@ -94,15 +94,52 @@ services: container_name: dockge ports: - 3555:5001 # le port accessible sur le réseau local sera 3555 - + environment: + - DOCKER_HOST=tcp://docker-socket-proxy:2375 + - DOCKGE_STACKS_DIR=/srv/docker volumes: - - /var/run/docker.sock:/var/run/docker.sock - /srv/docker/dockge/data:/app/data - /srv/docker:/srv/docker + networks: + - dockge-internal + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-dockge + security_opt: + - no-new-privileges:true + networks: + - dockge-internal + volumes: + - /var/run/docker.sock:/var/run/docker.sock:ro environment: - - DOCKGE_STACKS_DIR=/srv/docker + - CONTAINERS=1 + - IMAGES=1 + - NETWORKS=1 + - VOLUMES=1 + - EXEC=1 + - INFO=1 + - SYSTEM=1 + - POST=1 + - ALLOW_START=1 + - ALLOW_STOP=1 + - ALLOW_RESTARTS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run + +networks: + dockge-internal: + name: dockge-internal ``` +::warning +Dockge a besoin d'accéder à l'API Docker pour gérer toutes les autres stacks de ce serveur, ce qui équivaut à un accès root sur l'hôte. Plutôt que de monter directement `/var/run/docker.sock`, cette config place **Docker Socket Proxy** devant, qui n'autorise que les permissions dont Dockge a réellement besoin (conteneurs, images, réseaux, volumes, exec, actions de cycle de vie), sur leur propre réseau interne. Dockge n'a pas d'authentification intégrée par défaut, n'exposez donc jamais le port `3555` au-delà de votre réseau local sans le placer derrière [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik). +:: + Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et :kbd{value="Ctrl+X"} pour quitter. #### Lancer le conteneur @@ -149,12 +186,44 @@ services: - WATCHTOWER_LABEL_ENABLE=true - WATCHTOWER_CLEANUP=true - WATCHTOWER_REMOVE_VOLUMES=true + - DOCKER_HOST=tcp://docker-socket-proxy:2375 # Notifications Discord - décommentez si utilisées #- WATCHTOWER_NOTIFICATIONS=slack #- WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER=Watchtower #- WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL=${WH_URL} + networks: + - watchtower-internal + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-watchtower + security_opt: + - no-new-privileges:true + networks: + - watchtower-internal volumes: - - /var/run/docker.sock:/var/run/docker.sock + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + - IMAGES=1 + - NETWORKS=1 + - VOLUMES=1 + - INFO=1 + - SYSTEM=1 + - POST=1 + - ALLOW_START=1 + - ALLOW_STOP=1 + - ALLOW_RESTARTS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run + +networks: + watchtower-internal: + name: watchtower-internal ``` ::warning @@ -162,6 +231,10 @@ services: `WATCHTOWER_REMOVE_VOLUMES=true` supprime les volumes anonymes d'un conteneur dès qu'il est mis à jour. Combiné à un tag `latest`, une mise à jour automatique peut silencieusement effacer les données de toute app qui stocke encore quelque chose dans un volume anonyme (sans nom) plutôt qu'un bind mount. :: +::note +Cette config place **Docker Socket Proxy** devant l'API Docker plutôt que de monter directement `/var/run/docker.sock`, afin que Watchtower n'obtienne que les permissions dont il a réellement besoin (lister/tirer les images, recréer les conteneurs) plutôt qu'un accès root complet à l'hôte. +:: + #### Renseigner vos variables d'environnement Remplissez la section `.env` dans Dockge avec ce qui suit : diff --git a/content/fr/3.serveex/4.monitoring/2.dozzle.md b/content/fr/3.serveex/4.monitoring/2.dozzle.md index 7e37edb..56b37ab 100644 --- a/content/fr/3.serveex/4.monitoring/2.dozzle.md +++ b/content/fr/3.serveex/4.monitoring/2.dozzle.md @@ -43,10 +43,41 @@ services: - .env environment: - DOZZLE_HOSTNAME=${DOMAIN} + - DOCKER_HOST=tcp://docker-socket-proxy:2375 + networks: + - dozzle-internal + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-dozzle + security_opt: + - no-new-privileges:true + networks: + - dozzle-internal volumes: - - /var/run/docker.sock:/var/run/docker.sock + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + - IMAGES=1 + - INFO=1 + - EVENTS=1 + - ALLOW_LOGS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run + +networks: + dozzle-internal: + name: dozzle-internal ``` +::note +Dozzle ne fait que lire les logs des conteneurs, donc cette config place **Docker Socket Proxy** devant l'API Docker plutôt que de monter directement `/var/run/docker.sock`, en gardant `POST` totalement désactivé : Dozzle peut lister les conteneurs et streamer leurs logs, rien de plus. +:: + ::tip{icon=""} ✨ __Astuce :__ ajoutez le label watchtower à chaque conteneur pour automatiser les mises à jour @@ -189,7 +220,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Et voilà, Dozzle est maintenant exposé ! ## Protéger Dozzle avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `dozzle.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy) : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `dozzle.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [dozzle.subdomain.conf]{26-38,41-42} ## Version 2023/12/19 @@ -259,11 +290,11 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: ::tip{icon=""} -✨ __Astuce :__ vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `dozzle.subdomain.conf` et en retirant le `#` devant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +✨ __Astuce :__ vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `dozzle.subdomain.conf` et en retirant le `#` devant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: diff --git a/content/fr/3.serveex/4.monitoring/4.beszel.md b/content/fr/3.serveex/4.monitoring/4.beszel.md index cd67c3f..11416f5 100644 --- a/content/fr/3.serveex/4.monitoring/4.beszel.md +++ b/content/fr/3.serveex/4.monitoring/4.beszel.md @@ -53,13 +53,35 @@ services: network_mode: host volumes: - ./socket:/beszel_socket - - /var/run/docker.sock:/var/run/docker.sock:ro environment: LISTEN: /beszel_socket/beszel.sock + DOCKER_HOST: tcp://127.0.0.1:2375 # Ne retirez pas les guillemets autour de la clé KEY: ${KEY} + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-beszel + security_opt: + - no-new-privileges:true + ports: + - 127.0.0.1:2375:2375 + volumes: + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run ``` +::note +`beszel-agent` tourne avec `network_mode: host`, il ne peut donc pas rejoindre un réseau interne dédié comme les autres stacks proxifiées de ce site ; à la place, **Docker Socket Proxy** publie son API sur `127.0.0.1` uniquement, joignable depuis l'agent via l'interface de loopback de l'hôte, avec seulement `CONTAINERS=1` activé puisque l'agent n'a besoin que de lire les statistiques des conteneurs. +:: + ::tip{icon=""} ✨ __Astuce :__ ajoutez le label Watchtower à chaque conteneur pour automatiser les mises à jour. @@ -122,11 +144,28 @@ services: container_name: beszel-agent restart: unless-stopped network_mode: host - volumes: - - /var/run/docker.sock:/var/run/docker.sock:ro environment: LISTEN: ${PORT} KEY: ${KEY} + DOCKER_HOST: tcp://127.0.0.1:2375 + depends_on: + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-beszel + security_opt: + - no-new-privileges:true + ports: + - 127.0.0.1:2375:2375 + volumes: + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run ``` Et dans le `.env` : @@ -253,7 +292,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Et voilà ! Beszel est maintenant exposé ! ## Protéger Beszel avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `beszel.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy) : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `beszel.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [beszel.subdomain.conf]{26-38,41-42} ## Version 2023/12/19 @@ -316,11 +355,11 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: ::tip{icon=""} -✨ Vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `beszel.subdomain.conf` et en retirant le `#` devant `include /config/nginx/authentik-server.conf;` et `include /config/nginx/authentik-location.conf;`. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +✨ Vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `beszel.subdomain.conf` et en retirant le `#` devant `include /config/nginx/authentik-server.conf;` et `include /config/nginx/authentik-location.conf;`. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: diff --git a/content/fr/3.serveex/91.advanced/1.authentik.md b/content/fr/3.serveex/91.advanced/1.authentik.md index 1183db7..473c283 100644 --- a/content/fr/3.serveex/91.advanced/1.authentik.md +++ b/content/fr/3.serveex/91.advanced/1.authentik.md @@ -19,7 +19,7 @@ Authentik gère aussi l'authentification multifacteur, dont le TOTP (un code gé C'est une excellente alternative au VPN pour exposer des services en toute sécurité, en particulier ceux qui n'ont ni MFA ni protection de connexion (le tableau de bord de SWAG par exemple). -Authentik dispose d'une [documentation fournie](https://docs.goauthentik.io/docs/installation/docker-compose) et de [très bons tutoriels de Cooptonian](https://www.youtube.com/@cooptonian). Ici, nous verrons les bases en prenant Dockge comme exemple. +Authentik dispose d'une [documentation fournie](https://docs.goauthentik.io/install-config/install/docker-compose) et de [très bons tutoriels de Cooptonian](https://www.youtube.com/@cooptonian). Ici, nous verrons les bases en prenant Dockge comme exemple. Il y a deux modes principaux à connaître : @@ -156,24 +156,55 @@ services: AUTHENTIK_POSTGRESQL__USER: ${PG_USER:-authentik} AUTHENTIK_POSTGRESQL__NAME: ${PG_DB:-authentik} AUTHENTIK_POSTGRESQL__PASSWORD: ${PG_PASS} - # `user: root` and the docker socket volume are optional. - # See more for the docker socket integration here: + # `user: root` et l'intégration Docker ci-dessous sont optionnels, uniquement + # nécessaires si vous voulez qu'Authentik gère automatiquement des outposts + # intégrés sur cet hôte. Voir : # https://goauthentik.io/docs/outposts/integrations/docker - # Removing `user: root` also prevents the worker from fixing the permissions - # on the mounted folders, so when removing this make sure the folders have the correct UID/GID - # (1000:1000 by default) + # Retirer `user: root` empêche aussi le worker de corriger les permissions + # sur les dossiers montés, donc si vous le retirez, assurez-vous que ces + # dossiers ont le bon UID/GID (1000:1000 par défaut) user: root volumes: - - /var/run/docker.sock:/var/run/docker.sock - ./media:/media - ./certs:/certs - ./custom-templates:/templates - ./ssh:/authentik/.ssh + networks: + - default + - authentik-internal env_file: - .env depends_on: - postgresql - redis + - docker-socket-proxy + + docker-socket-proxy: + image: lscr.io/linuxserver/socket-proxy:latest + container_name: docker-socket-proxy-authentik + security_opt: + - no-new-privileges:true + networks: + - authentik-internal + volumes: + - /var/run/docker.sock:/var/run/docker.sock:ro + environment: + - CONTAINERS=1 + - IMAGES=1 + - NETWORKS=1 + - INFO=1 + - POST=1 + - ALLOW_START=1 + - ALLOW_STOP=1 + - ALLOW_RESTARTS=1 + restart: unless-stopped + read_only: true + tmpfs: + - /run + +networks: + authentik-internal: + name: authentik-internal volumes: database: @@ -182,6 +213,10 @@ volumes: driver: local ``` +::note +Ceci ajoute **Docker Socket Proxy** pour que l'intégration Docker optionnelle n'ait jamais besoin de `/var/run/docker.sock` monté directement dans le worker. Si vous l'activez, définissez l'URL Docker de la connexion dans l'interface d'administration sur `http://docker-socket-proxy:2375` plutôt que le chemin du socket local, comme le recommande [la documentation d'Authentik](https://goauthentik.io/docs/outposts/integrations/docker) pour les configurations avec socket-proxy. +:: + ### Démarrer la configuration initiale Dans le fichier `.env`, les variables `PG_PASS` et `AUTHENTIK_SECRET_KEY` sont déjà renseignées. @@ -322,7 +357,7 @@ Allez dans _Settings_, cliquez sur la section _MFA_, puis sur _Register_. Choisi Un code à usage unique vous sera désormais demandé à chaque connexion. ## Protéger une app native -Authentik est nativement compatible avec plusieurs applications. Vous trouverez la liste et [le support ici](https://docs.goauthentik.io/integrations/services/). +Authentik est nativement compatible avec plusieurs applications. Vous trouverez la liste et [le support ici](https://integrations.goauthentik.io/). ## Protéger une app par reverse proxy SWAG permet d'insérer la page de connexion d'Authentik entre une requête et l'accès à votre service. Pour cela : @@ -458,7 +493,7 @@ En ligne de commande : ```bash [Terminal] sudo nano /srv/docker/authentik-outpost/compose.yaml ``` -Collez la configuration suivante, en mettant à jour la version dans `{AUTHENTIK_TAG:proxy:2024.2.3}`{lang=properties} pour correspondre à celle de votre serveur Authentik. +Collez la configuration suivante, en mettant à jour la version dans `ghcr.io/goauthentik/proxy:2026.2`{lang=properties} pour correspondre à celle de votre serveur Authentik. ```yaml [compose.yaml] --- @@ -466,7 +501,7 @@ version: "3.5" services: authentik_proxy: container_name: authentik-outpost - image: ghcr.io/goauthentik/proxy:2024.2.3 + image: ghcr.io/goauthentik/proxy:2026.2 # Optionally specify which networks the container should be # might be needed to reach the core authentik server restart: unless-stopped @@ -585,7 +620,7 @@ Enregistrez avec :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"}, et quittez avec ### Terminé ! :: -Configurez ensuite les applications à protéger comme vous l'avez fait sur votre serveur principal, qu'elles soient [natives](/serveex/advanced/authentik/#protecting-a-native-app) ou protégées via [reverse proxy](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +Configurez ensuite les applications à protéger comme vous l'avez fait sur votre serveur principal, qu'elles soient [natives](/serveex/advanced/authentik/#protecting-a-native-app) ou protégées via [reverse proxy](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). ## Migrer une base de données Authentik diff --git a/content/fr/3.serveex/91.advanced/2.arcane.md b/content/fr/3.serveex/91.advanced/2.arcane.md index 3755976..9f6a4ab 100644 --- a/content/fr/3.serveex/91.advanced/2.arcane.md +++ b/content/fr/3.serveex/91.advanced/2.arcane.md @@ -72,7 +72,7 @@ services: docker-socket-proxy: image: lscr.io/linuxserver/socket-proxy:latest - container_name: arcane-docker-proxy + container_name: docker-socket-proxy-arcane security_opt: - no-new-privileges:true networks: @@ -248,7 +248,7 @@ Et voilà ! Arcane est maintenant accessible depuis internet. ## Connecter un hôte distant Arcane peut gérer plusieurs hôtes Docker depuis une seule instance. Chaque hôte distant fait tourner un conteneur **agent** léger qui se reconnecte à Arcane. Plutôt que d'exposer cette connexion sur internet, nous la ferons passer par le [VPN WireGuard](/serveex/core/wireguard) déjà mis en place plus tôt, ainsi le trafic de l'agent ne quitte jamais votre réseau privé. -::note{to="/serveex/core/wireguard#client-server-setup"} +::note{to="/serveex/core/wireguard#sur-le-serveur-client"} Ceci suppose que l'hôte Arcane et l'hôte distant font déjà tourner leur propre client WireGuard, connectés à votre VPN comme décrit dans **Client Server Setup**. Notez l'adresse VPN que wg-easy a attribuée à l'__hôte Arcane__ (par exemple `10.8.0.3`) ; c'est l'adresse que visera l'agent distant ci-dessous. :: @@ -299,7 +299,7 @@ Arcane gère OIDC nativement, vous pouvez donc exiger une connexion Pocket ID av ::steps{level="3"} ### Enregistrer Arcane comme client OIDC -[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#registering-an-oidc-client) nommé `arcane`, avec cette URL de callback : +[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#enregistrer-un-client-oidc) nommé `arcane`, avec cette URL de callback : ```text https://arcane.mondomaine.fr/auth/oidc/callback -- 2.54.0 From d1f3f4ff883596c0a46531c3081e466825902bac Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:42:48 +0200 Subject: [PATCH 09/20] Fix TinyAuth's Uptime-Kuma public-paths example: mislabeled tag and over-broad /api and /metrics exposure --- content/en/3.serveex/3.security/3.tinyauth.md | 8 ++++---- content/fr/3.serveex/3.security/3.tinyauth.md | 12 ++++++------ 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/content/en/3.serveex/3.security/3.tinyauth.md b/content/en/3.serveex/3.security/3.tinyauth.md index d7f2d81..003850c 100644 --- a/content/en/3.serveex/3.security/3.tinyauth.md +++ b/content/en/3.serveex/3.security/3.tinyauth.md @@ -12,7 +12,7 @@ description: Install TinyAuth, a lightweight forward-auth proxy, and pair it wit It supports a simple local username/password login out of the box, which is what we'll set up here. It can also delegate login to an external OIDC provider like [Pocket ID](/serveex/security/pocket-id) instead, so anyone visiting a protected app authenticates with a passkey via Pocket ID and then gets forwarded through: install Pocket ID afterwards and follow [its guide](/serveex/security/pocket-id#connecting-pocket-id-to-tinyauth) to connect the two. -- [TinyAuth documentation](https://tinyauth.app/docs) +- [TinyAuth documentation](https://tinyauth.app/docs/getting-started) - [TinyAuth on GitHub](https://github.com/tinyauthapp/tinyauth) ## Installation @@ -299,9 +299,9 @@ Sometimes you want most of an app locked behind TinyAuth, but a handful of paths A regex `location` block always takes priority over the plain `location /` block, no matter which one appears first in the file. So any path matched by a regex location you define runs its own `proxy_pass`, without ever reaching the `auth_request /tinyauth;` line in `location /`. -For example, to leave Uptime-Kuma's public status page and its assets open while protecting everything else: +For example, here's how to leave Uptime-Kuma's public status page and its assets open while protecting everything else. Only `api/status-page` is left public, not all of `/api`, since the rest of Uptime-Kuma's API is meant to stay behind authentication; `/metrics` (Uptime-Kuma's Prometheus endpoint) is left out of the regex entirely for the same reason: -```nginx [dockge.subdomain.conf]{9-16} +```nginx [uptime-kuma.subdomain.conf]{9-16} server { listen 443 ssl; listen [::]:443 ssl; @@ -310,7 +310,7 @@ server { include /config/nginx/ssl.conf; - location ~ ^/(status|assets|icon\.svg|api|upload|metrics) { + location ~ ^/(status|assets|icon\.svg|api/status-page|upload) { include /config/nginx/proxy.conf; include /config/nginx/resolver.conf; set $upstream_app uptime-kuma; diff --git a/content/fr/3.serveex/3.security/3.tinyauth.md b/content/fr/3.serveex/3.security/3.tinyauth.md index 8409028..95c68e0 100644 --- a/content/fr/3.serveex/3.security/3.tinyauth.md +++ b/content/fr/3.serveex/3.security/3.tinyauth.md @@ -10,9 +10,9 @@ description: Installer TinyAuth, un proxy de forward-auth léger, et l'associer ![tinyauth](/img/serveex/tinyauth.png) -Nativement il gère une simple connexion locale identifiant/mot de passe, c'est ce que nous mettrons en place ici. Il peut aussi déléguer la connexion à un fournisseur OIDC externe comme [Pocket ID](/serveex/security/pocket-id), de sorte que quiconque visite une application protégée s'authentifie avec une passkey via Pocket ID puis est redirigé : installez Pocket ID ensuite et suivez [son tutoriel](/serveex/security/pocket-id#connecting-pocket-id-to-tinyauth) pour relier les deux. +Nativement il gère une simple connexion locale identifiant/mot de passe, c'est ce que nous mettrons en place ici. Il peut aussi déléguer la connexion à un fournisseur OIDC externe comme [Pocket ID](/serveex/security/pocket-id), de sorte que quiconque visite une application protégée s'authentifie avec une passkey via Pocket ID puis est redirigé : installez Pocket ID ensuite et suivez [son tutoriel](/serveex/security/pocket-id#connecter-pocket-id-à-tinyauth) pour relier les deux. -- [Documentation de TinyAuth](https://tinyauth.app/docs) +- [Documentation de TinyAuth](https://tinyauth.app/docs/getting-started) - [TinyAuth sur GitHub](https://github.com/tinyauthapp/tinyauth) ## Installation @@ -277,7 +277,7 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: @@ -299,9 +299,9 @@ Il arrive qu'on veuille verrouiller l'essentiel d'une application derrière Tiny Un bloc `location` en expression régulière est toujours prioritaire sur le bloc `location /` simple, quel que soit celui qui apparaît en premier dans le fichier. Tout chemin correspondant à une location en regex que vous définissez exécute donc son propre `proxy_pass`, sans jamais atteindre la ligne `auth_request /tinyauth;` du `location /`. -Par exemple, pour laisser ouverte la page de statut publique d'Uptime-Kuma et ses ressources tout en protégeant le reste : +Par exemple, voici comment laisser ouverte la page de statut publique d'Uptime-Kuma et ses ressources tout en protégeant le reste. Seul `api/status-page` est laissé public, pas tout `/api`, car le reste de l'API d'Uptime-Kuma doit rester derrière l'authentification ; `/metrics` (l'endpoint Prometheus d'Uptime-Kuma) est volontairement absent de la regex pour la même raison : -```nginx [dockge.subdomain.conf]{9-16} +```nginx [uptime-kuma.subdomain.conf]{9-16} server { listen 443 ssl; listen [::]:443 ssl; @@ -310,7 +310,7 @@ server { include /config/nginx/ssl.conf; - location ~ ^/(status|assets|icon\.svg|api|upload|metrics) { + location ~ ^/(status|assets|icon\.svg|api/status-page|upload) { include /config/nginx/proxy.conf; include /config/nginx/resolver.conf; set $upstream_app uptime-kuma; -- 2.54.0 From 1ee2f3a8ac49c6ddee251949c88c2869a61a12d9 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:43:05 +0200 Subject: [PATCH 10/20] Fix lazydocker's hardcoded release URL, stale Debian forky link, and missing After=network.target on the Wake-on-LAN unit --- content/en/2.general/5.linux/3.handy-tools.md | 5 +++-- content/en/3.serveex/2.core/1.installation.md | 3 ++- content/fr/2.general/5.linux/3.handy-tools.md | 5 +++-- content/fr/3.serveex/2.core/1.installation.md | 3 ++- 4 files changed, 10 insertions(+), 6 deletions(-) diff --git a/content/en/2.general/5.linux/3.handy-tools.md b/content/en/2.general/5.linux/3.handy-tools.md index f0cce95..d44face 100644 --- a/content/en/2.general/5.linux/3.handy-tools.md +++ b/content/en/2.general/5.linux/3.handy-tools.md @@ -144,10 +144,11 @@ The one exception: it isn't packaged by Debian. It's a full text interface for D #### Download the latest release ```bash [Terminal] -curl -Lo /tmp/lazydocker.tar.gz "https://github.com/jesseduffield/lazydocker/releases/latest/download/lazydocker_0.25.2_Linux_x86_64.tar.gz" +LAZYDOCKER_VERSION=$(curl -s https://api.github.com/repos/jesseduffield/lazydocker/releases/latest | grep -Po '"tag_name": "v\K[^"]*') +curl -Lo /tmp/lazydocker.tar.gz "https://github.com/jesseduffield/lazydocker/releases/latest/download/lazydocker_${LAZYDOCKER_VERSION}_Linux_x86_64.tar.gz" ``` -Check the [releases page](https://github.com/jesseduffield/lazydocker/releases) for the current version number, and take `arm64` instead of `x86_64` if the server is a Raspberry Pi or similar. +The release asset's filename embeds the version number, so it can't be fetched with a plain `latest` link; the first command reads the current version from GitHub's API instead of hardcoding one that will go stale. Take `arm64` instead of `x86_64` if the server is a Raspberry Pi or similar. #### Install the binary diff --git a/content/en/3.serveex/2.core/1.installation.md b/content/en/3.serveex/2.core/1.installation.md index 379e8de..d31b291 100644 --- a/content/en/3.serveex/2.core/1.installation.md +++ b/content/en/3.serveex/2.core/1.installation.md @@ -20,7 +20,7 @@ The other reason is that it stays out of your way. Appliance systems like Unraid ### BIOS setup -Press :kbd{value="Del"} or :kbd{value="F2"} right after powering on to open the firmware setup (the boot screen usually says which key it is). Most machines also have a one-shot boot menu, often :kbd{value="F12"}, :kbd{value="F11"} or :kbd{value="F8"}, which lets you boot the USB installer once without touching the permanent boot order. Debian documents the general procedure in its [installation manual](https://www.debian.org/releases/forky/amd64/ch03s06.en.html), and here is what matters before you install: +Press :kbd{value="Del"} or :kbd{value="F2"} right after powering on to open the firmware setup (the boot screen usually says which key it is). Most machines also have a one-shot boot menu, often :kbd{value="F12"}, :kbd{value="F11"} or :kbd{value="F8"}, which lets you boot the USB installer once without touching the permanent boot order. Debian documents the general procedure in its [installation manual](https://www.debian.org/releases/trixie/amd64/ch03s06.en.html), and here is what matters before you install: - **Boot mode.** Prefer native UEFI. The important part is that the installer boots in the *same* mode you intend to run the server in, because UEFI uses GPT partitioning while legacy BIOS (and UEFI in CSM mode) uses a DOS partition table, and a mismatch installs the bootloader in the wrong place. Watch out on multi-boot machines: the default boot mode for removable devices is often not the one used for internal disks. - **Secure Boot** can stay enabled. Debian ships a Microsoft-signed shim bootloader, so it boots fine as-is. @@ -253,6 +253,7 @@ sudo nano /etc/systemd/system/wol.service ```ini [wol.service] [Unit] Description=Enable Wake on LAN +After=network.target [Service] Type=oneshot diff --git a/content/fr/2.general/5.linux/3.handy-tools.md b/content/fr/2.general/5.linux/3.handy-tools.md index addf4e1..171c9fa 100644 --- a/content/fr/2.general/5.linux/3.handy-tools.md +++ b/content/fr/2.general/5.linux/3.handy-tools.md @@ -145,10 +145,11 @@ La seule exception : il n'est pas empaqueté par Debian. C'est une interface tex #### Télécharger la dernière version ```bash [Terminal] -curl -Lo /tmp/lazydocker.tar.gz "https://github.com/jesseduffield/lazydocker/releases/latest/download/lazydocker_0.25.2_Linux_x86_64.tar.gz" +LAZYDOCKER_VERSION=$(curl -s https://api.github.com/repos/jesseduffield/lazydocker/releases/latest | grep -Po '"tag_name": "v\K[^"]*') +curl -Lo /tmp/lazydocker.tar.gz "https://github.com/jesseduffield/lazydocker/releases/latest/download/lazydocker_${LAZYDOCKER_VERSION}_Linux_x86_64.tar.gz" ``` -Vérifiez le numéro de version actuel sur la [page des releases](https://github.com/jesseduffield/lazydocker/releases), et prenez `arm64` au lieu de `x86_64` si le serveur est un Raspberry Pi ou équivalent. +Le nom du fichier de la release intègre le numéro de version, donc il ne peut pas être récupéré avec un simple lien `latest` ; la première commande lit la version actuelle depuis l'API GitHub plutôt que d'en coder une en dur qui finirait par devenir obsolète. Prenez `arm64` au lieu de `x86_64` si le serveur est un Raspberry Pi ou équivalent. #### Installer le binaire diff --git a/content/fr/3.serveex/2.core/1.installation.md b/content/fr/3.serveex/2.core/1.installation.md index 0689f60..79bf8fb 100644 --- a/content/fr/3.serveex/2.core/1.installation.md +++ b/content/fr/3.serveex/2.core/1.installation.md @@ -20,7 +20,7 @@ L'autre raison, c'est qu'il ne vous donnera aucune limite, il ne vous enfermera ### Réglages du BIOS -Appuyez sur :kbd{value="Del"} ou :kbd{value="F2"} juste après l'allumage de votre machine afin d'ouvrir le setup du BIOS (l'écran de démarrage indique généralement quelle touche c'est). La plupart des machines ont aussi un menu de démarrage ponctuel, souvent :kbd{value="F12"}, :kbd{value="F11"} ou :kbd{value="F8"}, qui permet de démarrer sur la clé USB une seule fois sans toucher à l'ordre de démarrage permanent. Debian documente la procédure générale dans son [manuel d'installation](https://www.debian.org/releases/forky/amd64/ch03s06.fr.html), et voici ce qui compte avant d'installer : +Appuyez sur :kbd{value="Del"} ou :kbd{value="F2"} juste après l'allumage de votre machine afin d'ouvrir le setup du BIOS (l'écran de démarrage indique généralement quelle touche c'est). La plupart des machines ont aussi un menu de démarrage ponctuel, souvent :kbd{value="F12"}, :kbd{value="F11"} ou :kbd{value="F8"}, qui permet de démarrer sur la clé USB une seule fois sans toucher à l'ordre de démarrage permanent. Debian documente la procédure générale dans son [manuel d'installation](https://www.debian.org/releases/trixie/amd64/ch03s06.fr.html), et voici ce qui compte avant d'installer : - **Mode de démarrage.** Préférez l'UEFI natif. Il est nécessaire que l'installateur démarre dans le *même* mode que celui dans lequel vous comptez faire tourner le serveur, parce que l'UEFI utilise un partitionnement GPT alors que le BIOS legacy (et l'UEFI en mode CSM) utilise une table de partitions DOS. Une incohérence installe le bootloader au mauvais endroit. Attention sur les machines multiboot : le mode de démarrage par défaut des périphériques amovibles n'est souvent pas celui utilisé pour les disques internes. - **Le Secure Boot** peut rester activé. Debian fournit un chargeur shim signé par Microsoft, il démarre donc très bien tel quel. @@ -254,6 +254,7 @@ sudo nano /etc/systemd/system/wol.service ```ini [wol.service] [Unit] Description=Enable Wake on LAN +After=network.target [Service] Type=oneshot -- 2.54.0 From 6447916039ddf2189e30f89341482f08addd38dd Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:43:11 +0200 Subject: [PATCH 11/20] Fix SWAG's duplicate save instruction, mods count, and Authentik outpost version mismatch --- content/fr/3.serveex/2.core/4.swag.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/fr/3.serveex/2.core/4.swag.md b/content/fr/3.serveex/2.core/4.swag.md index 1fc1eab..760b674 100644 --- a/content/fr/3.serveex/2.core/4.swag.md +++ b/content/fr/3.serveex/2.core/4.swag.md @@ -13,7 +13,7 @@ description: Configurer SWAG comme reverse proxy avec SSL automatique, exposer v SWAG n'a d'utilité que pour exposer vos services sur internet, c'est-à-dire y accéder via une URL publique du type `https://service.mondomaine.fr`. Si vous ne souhaitez pas exposer vos services et préférez systématiquement passer par un VPN pour vous connecter à distance, allez plutôt **par ici**. :: -Ci-dessous, un exemple exposant Dockge. Nous installerons SWAG ainsi que le mod dbip servant à bloquer les connexions selon la géolocalisation, et le mod dashboard qui permet de piloter swag, fail2ban et la géolocalisation. +Ci-dessous, un exemple exposant Dockge. Nous installerons SWAG ainsi que le mod dbip servant à bloquer les connexions selon la géolocalisation, le mod dashboard qui permet de piloter swag, fail2ban et la géolocalisation, et le mod auto-reload qui recharge automatiquement nginx dès qu'un fichier de configuration change, sans avoir à redémarrer le conteneur. **Principe d'un reverse proxy et application dans notre cas :** @@ -155,7 +155,7 @@ Donnez-lui les permissions suivantes : * `POST /domain/zone/*` * `DELETE /domain/zone/*` -Notez temporairement les 3 clés et saisissez-les dans `ovh.ini`. (Dans nano, tapez directement, puis :kbd{value="Ctrl+O"}, :kbd{value="Enter"}, :kbd{value="Ctrl+X"} pour enregistrer et quitter) +Notez temporairement les 3 clés et saisissez-les dans `ovh.ini`. Enregistrez avec :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"}, et quittez avec :kbd{value="Ctrl+X"}. -- 2.54.0 From a470377d4fa946c44e20908ed883f6fd7cf9d407 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:43:53 +0200 Subject: [PATCH 12/20] Fix dead goauthentik integrations link and hardcoded absolute internal links with a language prefix --- content/en/5.nonsense/3.bash/5.backrest-docker-stop.md | 2 +- content/en/6.recycled/3.alternatives/4.gitea.md | 2 +- content/fr/5.nonsense/3.bash/5.backrest-docker-stop.md | 2 +- content/fr/6.recycled/3.alternatives/4.gitea.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/5.nonsense/3.bash/5.backrest-docker-stop.md b/content/en/5.nonsense/3.bash/5.backrest-docker-stop.md index 63a7cab..cf717eb 100644 --- a/content/en/5.nonsense/3.bash/5.backrest-docker-stop.md +++ b/content/en/5.nonsense/3.bash/5.backrest-docker-stop.md @@ -6,7 +6,7 @@ description: A bash script that stops Docker containers before a Backrest backup :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -[Backrest](https://github.com/garethgeorge/backrest) is a fantastic backup tool. In the case of [Serveex](https://docu.djeex.fr/en/serveex/introduction), most of the data that needs to be backed up consists of containers, and those containers often include databases. +[Backrest](https://github.com/garethgeorge/backrest) is a fantastic backup tool. In the case of [Serveex](/serveex/introduction), most of the data that needs to be backed up consists of containers, and those containers often include databases. The problem? You can’t safely back up a database while it’s running. There are plenty of complex solutions involving database dumps, but often the simplest method is to stop the containers, perform the backup, and then restart them. diff --git a/content/en/6.recycled/3.alternatives/4.gitea.md b/content/en/6.recycled/3.alternatives/4.gitea.md index f99f624..5de0110 100644 --- a/content/en/6.recycled/3.alternatives/4.gitea.md +++ b/content/en/6.recycled/3.alternatives/4.gitea.md @@ -209,5 +209,5 @@ Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ct And that’s it! Gitea is now exposed to the web. ::tip{icon=""} -✨ __Tip:__ You can protect this app natively via OIDC with [Pocket ID](/serveex/security/pocket-id) (register it as an OIDC client), or with Authentik by [following these instructions](https://docs.goauthentik.io/integrations/services/gitea/). +✨ __Tip:__ You can protect this app natively via OIDC with [Pocket ID](/serveex/security/pocket-id) (register it as an OIDC client), or with Authentik by [following these instructions](https://integrations.goauthentik.io/development/gitea/). :: diff --git a/content/fr/5.nonsense/3.bash/5.backrest-docker-stop.md b/content/fr/5.nonsense/3.bash/5.backrest-docker-stop.md index 58db6c2..daa8de0 100644 --- a/content/fr/5.nonsense/3.bash/5.backrest-docker-stop.md +++ b/content/fr/5.nonsense/3.bash/5.backrest-docker-stop.md @@ -6,7 +6,7 @@ description: Un script bash qui arrête les conteneurs Docker avant une sauvegar :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -[Backrest](https://github.com/garethgeorge/backrest) est un formidable outil de backup. Dans le cas de [Serveex](https://docu.djeex.fr/fr/serveex/introduction), la majeure partie des données à sauvegarder sont des conteneurs, et souvent ces conteneurs possèdent des bases de données. +[Backrest](https://github.com/garethgeorge/backrest) est un formidable outil de backup. Dans le cas de [Serveex](/serveex/introduction), la majeure partie des données à sauvegarder sont des conteneurs, et souvent ces conteneurs possèdent des bases de données. Le problème ? On ne peut pas sauvegarder proprement une BDD qui est en route. Alors, il existe plein de solutions complexe à base de dump des bases de données, mais souvent le plus simple cela reste de stopper les conteneurs, de sauvegarder, et de redémarrer les conteneurs. diff --git a/content/fr/6.recycled/3.alternatives/4.gitea.md b/content/fr/6.recycled/3.alternatives/4.gitea.md index da83d87..bad6fb8 100644 --- a/content/fr/6.recycled/3.alternatives/4.gitea.md +++ b/content/fr/6.recycled/3.alternatives/4.gitea.md @@ -209,5 +209,5 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Et voilà ! Gitea est maintenant exposé sur le web. ::tip{icon=""} -✨ __Astuce :__ vous pouvez protéger cette application nativement en OIDC avec [Pocket ID](/serveex/security/pocket-id) (en l'enregistrant comme client OIDC), ou avec Authentik en [suivant ces instructions](https://docs.goauthentik.io/integrations/services/gitea/). +✨ __Astuce :__ vous pouvez protéger cette application nativement en OIDC avec [Pocket ID](/serveex/security/pocket-id) (en l'enregistrant comme client OIDC), ou avec Authentik en [suivant ces instructions](https://integrations.goauthentik.io/development/gitea/). :: -- 2.54.0 From fbc33a5ff4d1f657e9e49566a48ff457cf1d6765 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:44:01 +0200 Subject: [PATCH 13/20] Fix ~50 cross-language anchor links pointing at the other language's heading slug --- content/en/3.serveex/1.introduction.md | 2 +- content/en/3.serveex/5.media/2.qbittorrent.md | 2 +- content/fr/3.serveex/4.monitoring/1.uptime-kuma.md | 6 +++--- content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md | 6 +++--- content/fr/3.serveex/4.monitoring/5.upsnap.md | 6 +++--- content/fr/3.serveex/5.media/1.jellyfin.md | 4 ++-- content/fr/3.serveex/5.media/2.qbittorrent.md | 8 ++++---- content/fr/3.serveex/5.media/3.servarr.md | 6 +++--- content/fr/3.serveex/6.cloud/1.immich.md | 2 +- content/fr/3.serveex/6.cloud/2.nextcloud.md | 2 +- content/fr/3.serveex/7.files/1.file-browser-quantum.md | 6 +++--- content/fr/3.serveex/7.files/2.pingvin.md | 2 +- content/fr/3.serveex/8.development/1.code-server.md | 6 +++--- content/fr/3.serveex/8.development/2.forgejo.md | 2 +- content/fr/3.serveex/8.development/3.it-tools.md | 6 +++--- content/fr/3.serveex/9.apps/1.adguard.md | 4 ++-- content/fr/3.serveex/9.apps/2.vaultwarden.md | 2 +- content/fr/6.recycled/2.deprecated/2.file-browser.md | 6 +++--- content/fr/6.recycled/3.alternatives/1.plex.md | 2 +- .../6.recycled/3.alternatives/2.qbittorrent for plex.md | 2 +- 20 files changed, 41 insertions(+), 41 deletions(-) diff --git a/content/en/3.serveex/1.introduction.md b/content/en/3.serveex/1.introduction.md index feaa943..16d7d79 100644 --- a/content/en/3.serveex/1.introduction.md +++ b/content/en/3.serveex/1.introduction.md @@ -47,7 +47,7 @@ Install Docker --- icon: i-carbon-container-registry title: Container manager -to: "/serveex/core/docker#installer-dockge-pour-gérer-et-déployer-les-conteneurs" +to: "/serveex/core/docker#install-dockge-to-manage-and-deploy-containers" ui: icon: text-[#74C2FF] --- diff --git a/content/en/3.serveex/5.media/2.qbittorrent.md b/content/en/3.serveex/5.media/2.qbittorrent.md index f2d668a..50a5df3 100644 --- a/content/en/3.serveex/5.media/2.qbittorrent.md +++ b/content/en/3.serveex/5.media/2.qbittorrent.md @@ -194,7 +194,7 @@ Detailed info: Once done, deploy the container. -::note{to="/serveex/core/docker/#dockge"} +::note{to="/serveex/core/docker#install-dockge-to-manage-and-deploy-containers"} **Startup logs will show a temporary password for `admin` user.** See logs in **Dockge** to retrieve it, or type this command in a terminal: diff --git a/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md b/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md index 294a79b..46a58aa 100644 --- a/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md +++ b/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md @@ -179,7 +179,7 @@ Nous partons ici du principe que le nom du réseau d'Uptime-Kuma est `uptime-kum Et voilà ! Uptime-Kuma est maintenant exposé, et vous pouvez y accéder via `https://stats.mondomaine.fr`. ## Protéger Uptime-Kuma avec TinyAuth -[TinyAuth](/serveex/security/tinyauth) peut se placer devant Uptime-Kuma comme devant n'importe quelle autre application, mais ici nous voulons aussi que la page de statut publique (et les ressources dont elle a besoin pour s'afficher) reste joignable sans se connecter. Cela utilise la même technique de `location` en expression régulière que [Laisser certains chemins publics](/serveex/security/tinyauth#leaving-specific-paths-public), appliquée directement à `stats.subdomain.conf`. +[TinyAuth](/serveex/security/tinyauth) peut se placer devant Uptime-Kuma comme devant n'importe quelle autre application, mais ici nous voulons aussi que la page de statut publique (et les ressources dont elle a besoin pour s'afficher) reste joignable sans se connecter. Cela utilise la même technique de `location` en expression régulière que [Laisser certains chemins publics](/serveex/security/tinyauth#laisser-certains-chemins-publics), appliquée directement à `stats.subdomain.conf`. ::steps{level="3"} ### Ouvrir le fichier subdomain.conf @@ -238,7 +238,7 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: @@ -251,7 +251,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Redéployez la stack. Uptime-Kuma sera alors joignable publiquement via `https://stats.mondomaine.fr`, avec la page de statut ouverte et tout le reste derrière TinyAuth. ::tip{icon=""} -✨ __Astuce :__ vous pouvez aussi protéger cette application avec [Authentik](/serveex/advanced/authentik) à la place : ouvrez `stats.subdomain.conf` et décommentez les lignes `include /config/nginx/authentik-server.conf;` et `include /config/nginx/authentik-location.conf;`. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). Modifiez ensuite le provider Uptime-Kuma, et dans *Advanced Protocol Settings > Authenticated Paths*, saisissez : +✨ __Astuce :__ vous pouvez aussi protéger cette application avec [Authentik](/serveex/advanced/authentik) à la place : ouvrez `stats.subdomain.conf` et décommentez les lignes `include /config/nginx/authentik-server.conf;` et `include /config/nginx/authentik-location.conf;`. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). Modifiez ensuite le provider Uptime-Kuma, et dans *Advanced Protocol Settings > Authenticated Paths*, saisissez : ```properties ^/$ diff --git a/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md b/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md index 8a084f4..e836f5f 100644 --- a/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md +++ b/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md @@ -200,7 +200,7 @@ Ceci suppose que le réseau de Speedtest Tracker s'appelle `speedtest-tracker_de Patientez un instant, puis visitez `https://speedtest.mondomaine.fr` dans votre navigateur. Vous devriez être redirigé vers Speedtest Tracker. Vous pouvez vérifier l'état du service via le tableau de bord (`http://ipdevotreserveur:81` depuis le réseau local). ## Protéger Speedtest Tracker avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `speedtest.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy) : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `speedtest.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [speedtest.subdomain.conf]{22-34,37-38} ## Version 2023/12/19 @@ -262,7 +262,7 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: @@ -270,5 +270,5 @@ Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWA ::tip{icon=""} ✨ Vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `speedtest.subdomain.conf` et en décommentant `include /config/nginx/authentik-server.conf;` et `include /config/nginx/authentik-location.conf;`. -N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: diff --git a/content/fr/3.serveex/4.monitoring/5.upsnap.md b/content/fr/3.serveex/4.monitoring/5.upsnap.md index c83fdfd..717f57e 100644 --- a/content/fr/3.serveex/4.monitoring/5.upsnap.md +++ b/content/fr/3.serveex/4.monitoring/5.upsnap.md @@ -201,7 +201,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Et voilà ! Vous avez exposé UpSnap ! ## Protéger UpSnap avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `upsnap.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy) : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `upsnap.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [upsnap.subdomain.conf]{26-38,41-42} ## Version 2023/12/19 @@ -271,11 +271,11 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: ::tip{icon=""} -✨ Vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `upsnap.subdomain.conf` et en retirant le `#` devant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +✨ Vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `upsnap.subdomain.conf` et en retirant le `#` devant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: diff --git a/content/fr/3.serveex/5.media/1.jellyfin.md b/content/fr/3.serveex/5.media/1.jellyfin.md index b5d48de..ea364d5 100644 --- a/content/fr/3.serveex/5.media/1.jellyfin.md +++ b/content/fr/3.serveex/5.media/1.jellyfin.md @@ -192,7 +192,7 @@ Jellyfin ne sera pas exposé sur internet dans ce site, contrairement à la plup Plutôt que de faire passer tout le trafic d'un appareil par le VPN, ou même tout le sous-réseau VPN `10.8.0.0/24`, nous utiliserons un **split tunnel** plus serré : chaque appareil distant ne route par le tunnel que le trafic destiné à l'adresse VPN de votre serveur. Tout le reste (navigation, autres applications) reste sur la connexion normale de l'appareil, et le VPN ne sert jamais qu'à joindre cette seule machine. -::note{to="/serveex/core/wireguard#client-server-setup"} +::note{to="/serveex/core/wireguard#sur-le-serveur-client"} Ceci suppose que votre serveur Jellyfin fait déjà tourner son propre client WireGuard, le reliant à votre VPN comme décrit dans **Client Server Setup**. Notez l'adresse VPN que wg-easy lui a attribuée (par exemple `10.8.0.2`) ; c'est l'adresse que viseront tous les appareils ci-dessous. :: @@ -204,7 +204,7 @@ Ce split tunnel est une convention côté client, pas une frontière de sécurit ::steps{level="3"} ### Créer un client dans wg-easy pour chaque appareil -En suivant [Récupérer les fichiers de configuration](/serveex/core/wireguard#retrieve-configuration-files), créez un client par appareil (téléphone, ordinateur, TV/boîtier multimédia) et téléchargez son fichier de configuration. +En suivant [Récupérer les fichiers de configuration](/serveex/core/wireguard#récupérer-les-fichiers-de-configuration), créez un client par appareil (téléphone, ordinateur, TV/boîtier multimédia) et téléchargez son fichier de configuration. ### Restreindre le tunnel au seul serveur diff --git a/content/fr/3.serveex/5.media/2.qbittorrent.md b/content/fr/3.serveex/5.media/2.qbittorrent.md index cb56d8c..44e9962 100644 --- a/content/fr/3.serveex/5.media/2.qbittorrent.md +++ b/content/fr/3.serveex/5.media/2.qbittorrent.md @@ -194,7 +194,7 @@ Détail : Une fois fait, déployez le conteneur. -::note{to="/serveex/core/docker/#dockge"} +::note{to="/serveex/core/docker#installer-dockge-pour-gérer-et-déployer-les-conteneurs"} **Les logs de démarrage affichent un mot de passe temporaire pour l'utilisateur `admin`.** Consultez les logs dans **Dockge** pour le récupérer, ou tapez cette commande dans un terminal : @@ -337,7 +337,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Attendez quelques minutes, puis allez sur `https://seedbox.mondomaine.fr`. Vous devriez arriver sur l'interface de Qbittorrent. ## Protéger Qbittorrent avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `seedbox.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy) : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `seedbox.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [seedbox.subdomain.conf]{26-38,41-42} ## Version 2023/12/19 @@ -407,13 +407,13 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: ::tip{icon=""} -✨ Vous pouvez sécuriser cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en décommentant les lignes `authentik-server.conf` et `authentik-location.conf`. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +✨ Vous pouvez sécuriser cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en décommentant les lignes `authentik-server.conf` et `authentik-location.conf`. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: Et voilà ! Vous avez maintenant un media center prêt à l'emploi. diff --git a/content/fr/3.serveex/5.media/3.servarr.md b/content/fr/3.serveex/5.media/3.servarr.md index a390482..2b10de0 100644 --- a/content/fr/3.serveex/5.media/3.servarr.md +++ b/content/fr/3.serveex/5.media/3.servarr.md @@ -514,7 +514,7 @@ __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. Et voilà, Seerr est maintenant accessible publiquement ! ## Protéger Seerr avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `films.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy). L'interface web (`/`) reçoit la vérification, `/api` en est exclu, puisque les appels d'API de Seerr (et tout ce qui s'y intègre) ne peuvent pas faire de connexion interactive dans un navigateur : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `films.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy). L'interface web (`/`) reçoit la vérification, `/api` en est exclu, puisque les appels d'API de Seerr (et tout ce qui s'y intègre) ne peuvent pas faire de connexion interactive dans un navigateur : ```nginx [films.subdomain.conf]{24-36,39-40} ## Version 2024/07/16 @@ -592,11 +592,11 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: ::tip{icon=""} -✨ Vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `films.subdomain.conf` et en retirant le `#` devant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +✨ Vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `films.subdomain.conf` et en retirant le `#` devant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: diff --git a/content/fr/3.serveex/6.cloud/1.immich.md b/content/fr/3.serveex/6.cloud/1.immich.md index 3b09557..34343a6 100644 --- a/content/fr/3.serveex/6.cloud/1.immich.md +++ b/content/fr/3.serveex/6.cloud/1.immich.md @@ -177,7 +177,7 @@ Immich gère OIDC nativement, vous pouvez donc exiger une connexion Pocket ID av ::steps{level="3"} ### Enregistrer Immich comme client OIDC -[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#registering-an-oidc-client) nommé `immich`, avec ces trois URL de callback : +[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#enregistrer-un-client-oidc) nommé `immich`, avec ces trois URL de callback : ```text https://immich.mondomaine.fr/auth/login diff --git a/content/fr/3.serveex/6.cloud/2.nextcloud.md b/content/fr/3.serveex/6.cloud/2.nextcloud.md index cdc1ccf..d89511d 100644 --- a/content/fr/3.serveex/6.cloud/2.nextcloud.md +++ b/content/fr/3.serveex/6.cloud/2.nextcloud.md @@ -212,7 +212,7 @@ Dans Nextcloud, allez dans _Apps > Integration_ et installez __OpenID Connect us ### Enregistrer Nextcloud comme client OIDC -[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#registering-an-oidc-client) nommé `Nextcloud`, avec cette URL de callback : +[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#enregistrer-un-client-oidc) nommé `Nextcloud`, avec cette URL de callback : ```text https://nextcloud.mondomaine.fr/apps/user_oidc/code diff --git a/content/fr/3.serveex/7.files/1.file-browser-quantum.md b/content/fr/3.serveex/7.files/1.file-browser-quantum.md index 9a60d0e..a0e10b7 100644 --- a/content/fr/3.serveex/7.files/1.file-browser-quantum.md +++ b/content/fr/3.serveex/7.files/1.file-browser-quantum.md @@ -211,7 +211,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Et voilà ! File Browser Quantum est maintenant exposé. ## Protéger File Browser Quantum avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `fbq.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy) : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `fbq.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [fbq.subdomain.conf]{22-34,37-38} ## Version 2023/12/19 @@ -276,11 +276,11 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: ::tip{icon=""} -✨ __Astuce :__ vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `fbq.subdomain.conf` et en décommentant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +✨ __Astuce :__ vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `fbq.subdomain.conf` et en décommentant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: diff --git a/content/fr/3.serveex/7.files/2.pingvin.md b/content/fr/3.serveex/7.files/2.pingvin.md index 483b268..b219e86 100644 --- a/content/fr/3.serveex/7.files/2.pingvin.md +++ b/content/fr/3.serveex/7.files/2.pingvin.md @@ -190,7 +190,7 @@ Pingvin gère OIDC nativement, vous pouvez donc exiger une connexion Pocket ID a ::steps{level="3"} ### Enregistrer Pingvin comme client OIDC -[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#registering-an-oidc-client) nommé `pingvin`, avec cette URL de callback : +[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#enregistrer-un-client-oidc) nommé `pingvin`, avec cette URL de callback : ```text https://pingvin.mondomaine.fr/api/oauth/callback/oidc diff --git a/content/fr/3.serveex/8.development/1.code-server.md b/content/fr/3.serveex/8.development/1.code-server.md index d1da7fd..e521cda 100644 --- a/content/fr/3.serveex/8.development/1.code-server.md +++ b/content/fr/3.serveex/8.development/1.code-server.md @@ -227,7 +227,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Et voilà ! code-server est maintenant exposé ! ## Protéger code-server avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `code.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy) : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `code.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [code.subdomain.conf]{26-38,41-42} ## Version 2023/12/19 @@ -296,11 +296,11 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: ::tip{icon=""} -✨ __Astuce :__ vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `code.subdomain.conf` et en décommentant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +✨ __Astuce :__ vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `code.subdomain.conf` et en décommentant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: diff --git a/content/fr/3.serveex/8.development/2.forgejo.md b/content/fr/3.serveex/8.development/2.forgejo.md index 023087e..32566b8 100644 --- a/content/fr/3.serveex/8.development/2.forgejo.md +++ b/content/fr/3.serveex/8.development/2.forgejo.md @@ -212,7 +212,7 @@ Forgejo peut aussi déléguer la connexion à un fournisseur OIDC plutôt qu'à ::steps{level="3"} ### Enregistrer Forgejo comme client OIDC -[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#registering-an-oidc-client) nommé `Forgejo`, avec cette URL de callback : +[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#enregistrer-un-client-oidc) nommé `Forgejo`, avec cette URL de callback : ```text https://forgejo.mondomaine.fr/user/oauth2/PocketID/callback diff --git a/content/fr/3.serveex/8.development/3.it-tools.md b/content/fr/3.serveex/8.development/3.it-tools.md index 83df628..0dd71d3 100644 --- a/content/fr/3.serveex/8.development/3.it-tools.md +++ b/content/fr/3.serveex/8.development/3.it-tools.md @@ -166,7 +166,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Et voilà ! IT Tools est maintenant exposé ! ## Protéger IT Tools avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `tools.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy) : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `tools.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [tools.subdomain.conf]{26-38,41-42} ## Version 2023/12/19 @@ -236,11 +236,11 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: ::tip{icon=""} -✨ __Astuce :__ vous pouvez sécuriser cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `tools.subdomain.conf` et en décommentant les lignes `include /config/nginx/authentik-server.conf;` et `include /config/nginx/authentik-location.conf;`. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +✨ __Astuce :__ vous pouvez sécuriser cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `tools.subdomain.conf` et en décommentant les lignes `include /config/nginx/authentik-server.conf;` et `include /config/nginx/authentik-location.conf;`. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: diff --git a/content/fr/3.serveex/9.apps/1.adguard.md b/content/fr/3.serveex/9.apps/1.adguard.md index aab4092..b1b99c9 100644 --- a/content/fr/3.serveex/9.apps/1.adguard.md +++ b/content/fr/3.serveex/9.apps/1.adguard.md @@ -240,7 +240,7 @@ server { :: ## Protéger AdGuard avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `adguard.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy). Le `location /dns-query` est laissé en dehors de la vérification `auth_request`, puisque les clients DNS-over-HTTPS ne peuvent pas faire de connexion interactive : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `adguard.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy). Le `location /dns-query` est laissé en dehors de la vérification `auth_request`, puisque les clients DNS-over-HTTPS ne peuvent pas faire de connexion interactive : ```nginx [adguard.subdomain.conf]{28-40,43-44,69-70} ## Version 2023/05/31 @@ -337,7 +337,7 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: diff --git a/content/fr/3.serveex/9.apps/2.vaultwarden.md b/content/fr/3.serveex/9.apps/2.vaultwarden.md index 3bf6439..d9538ef 100644 --- a/content/fr/3.serveex/9.apps/2.vaultwarden.md +++ b/content/fr/3.serveex/9.apps/2.vaultwarden.md @@ -257,7 +257,7 @@ Contrairement à la plupart des applications de ce site, Vaultwarden gère OIDC ::steps{level="3"} ### Enregistrer Vaultwarden comme client OIDC -[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#registering-an-oidc-client) (ou dans Authentik, ou tout autre fournisseur OIDC) avec cette URL de callback : +[Enregistrez un client OIDC dans Pocket ID](/serveex/security/pocket-id#enregistrer-un-client-oidc) (ou dans Authentik, ou tout autre fournisseur OIDC) avec cette URL de callback : ```text https://vault.mondomaine.fr/identity/connect/oidc-signin diff --git a/content/fr/6.recycled/2.deprecated/2.file-browser.md b/content/fr/6.recycled/2.deprecated/2.file-browser.md index a69dfad..bff4f23 100644 --- a/content/fr/6.recycled/2.deprecated/2.file-browser.md +++ b/content/fr/6.recycled/2.deprecated/2.file-browser.md @@ -169,7 +169,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et Et voilà ! File Browser est maintenant exposé ! ## Protéger File Browser avec TinyAuth -Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `files.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy) : +Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `files.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [files.subdomain.conf]{26-38,41-42} ## Version 2023/12/19 @@ -238,11 +238,11 @@ server { } ``` -::note{to="/serveex/security/tinyauth#exposing-tinyauth-with-swag"} +::note{to="/serveex/security/tinyauth#exposer-tinyauth-avec-swag"} Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWAG doit donc être sur le réseau Docker de TinyAuth pour le joindre par son nom (`tinyauth` ici). Cela devrait déjà être en place depuis **l'exposition de TinyAuth**. Si vous rencontrez une erreur, revérifiez que le fichier compose de SWAG a toujours ce réseau rattaché. :: ::tip{icon=""} -✨ __Astuce :__ vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `files.subdomain.conf` et en décommentant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). +✨ __Astuce :__ vous pouvez protéger cette application avec [Authentik](/serveex/advanced/authentik) plutôt que TinyAuth, en ouvrant `files.subdomain.conf` et en décommentant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. N'oubliez pas de [créer une application et un provider dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). :: diff --git a/content/fr/6.recycled/3.alternatives/1.plex.md b/content/fr/6.recycled/3.alternatives/1.plex.md index b1befa7..611e7ba 100644 --- a/content/fr/6.recycled/3.alternatives/1.plex.md +++ b/content/fr/6.recycled/3.alternatives/1.plex.md @@ -306,7 +306,7 @@ server { } ``` -::tip{icon="" to="/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy"} +::tip{icon="" to="/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy"} ✨ Vous pouvez protéger cette application avec Authentik en retirant le `#` devant `include /config/nginx/authentik-server.conf;` et `include /config/nginx/authentik-location.conf;`. N'oubliez pas de **créer une application et un provider dans Authentik**. :: diff --git a/content/fr/6.recycled/3.alternatives/2.qbittorrent for plex.md b/content/fr/6.recycled/3.alternatives/2.qbittorrent for plex.md index bd01a3b..6dbb6e2 100644 --- a/content/fr/6.recycled/3.alternatives/2.qbittorrent for plex.md +++ b/content/fr/6.recycled/3.alternatives/2.qbittorrent for plex.md @@ -330,7 +330,7 @@ server { } ``` -::tip{icon="" to="/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy"} +::tip{icon="" to="/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy"} ✨ Vous pouvez sécuriser cette application avec Authentik en décommentant les lignes `authentik-server.conf` et `authentik-location.conf`. N'oubliez pas de **créer une application et un provider dans Authentik**. :: -- 2.54.0 From 328aa3160072eed5359f1b48317bdd2775e7818e Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:49:44 +0200 Subject: [PATCH 14/20] Fix Done! spacing site-wide, and EN-only content errors (Docker/Linux mixup, missing spaces, ProloNAS pun explanation) --- content/en/1.about/1.welcome.md | 2 +- content/en/2.general/2.networking/3.samba.md | 4 ++-- content/en/2.general/4.hardware/3.prolonas.md | 8 ++++---- content/en/2.general/5.linux/1.cli-basics.md | 2 +- content/en/2.general/5.linux/3.handy-tools.md | 12 ++++++------ content/en/3.serveex/2.core/1.installation.md | 12 ++++++------ content/en/3.serveex/2.core/2.docker.md | 6 +++--- content/en/3.serveex/2.core/3.wireguard.md | 6 +++--- content/en/3.serveex/2.core/4.swag.md | 6 +++--- content/en/3.serveex/3.security/2.cloudflare.md | 4 ++-- content/en/3.serveex/3.security/3.tinyauth.md | 8 ++++---- content/en/3.serveex/3.security/4.pocket-id.md | 8 ++++---- content/en/3.serveex/4.monitoring/1.uptime-kuma.md | 6 +++--- content/en/3.serveex/4.monitoring/2.dozzle.md | 4 ++-- .../en/3.serveex/4.monitoring/3.speedtest-tracker.md | 4 ++-- content/en/3.serveex/4.monitoring/4.beszel.md | 4 ++-- content/en/3.serveex/4.monitoring/5.upsnap.md | 4 ++-- content/en/3.serveex/5.media/1.jellyfin.md | 8 ++++---- content/en/3.serveex/5.media/2.qbittorrent.md | 6 +++--- content/en/3.serveex/5.media/3.servarr.md | 12 ++++++------ content/en/3.serveex/6.cloud/1.immich.md | 6 +++--- content/en/3.serveex/6.cloud/2.nextcloud.md | 6 +++--- .../en/3.serveex/7.files/1.file-browser-quantum.md | 4 ++-- content/en/3.serveex/7.files/2.pingvin.md | 8 ++++---- content/en/3.serveex/8.development/1.code-server.md | 4 ++-- content/en/3.serveex/8.development/2.forgejo.md | 6 +++--- content/en/3.serveex/8.development/3.it-tools.md | 4 ++-- content/en/3.serveex/9.apps/1.adguard.md | 4 ++-- content/en/3.serveex/9.apps/2.vaultwarden.md | 8 ++++---- content/en/3.serveex/91.advanced/1.authentik.md | 12 ++++++------ content/en/3.serveex/91.advanced/2.arcane.md | 8 ++++---- content/en/5.nonsense/3.bash/6.rm-confirmation.md | 2 +- content/en/6.recycled/2.deprecated/1.wireguard-14.md | 4 ++-- content/en/6.recycled/2.deprecated/2.file-browser.md | 4 ++-- content/en/6.recycled/3.alternatives/1.plex.md | 4 ++-- .../3.alternatives/2.qbittorrent for plex.md | 6 +++--- .../6.recycled/3.alternatives/3.servarr for plex.md | 12 ++++++------ content/en/6.recycled/3.alternatives/4.gitea.md | 4 ++-- 38 files changed, 116 insertions(+), 116 deletions(-) diff --git a/content/en/1.about/1.welcome.md b/content/en/1.about/1.welcome.md index dfea7af..e307292 100644 --- a/content/en/1.about/1.welcome.md +++ b/content/en/1.about/1.welcome.md @@ -18,7 +18,7 @@ Special thanks to __Nipah__, __Xenio__, __KevOut__ and others for their patience ## About the documentation -The documentation provided here is experimental and shared in a spirit of open knowledge and experience. It is not intended to build production-grade or industrialized infrastructure. It may contain mistakes and/or approximations. +The documentation provided here is experimental and shared in a spirit of open knowledge and experience. It is not intended to build production-grade or industrialized infrastructure. It may contain mistakes and/or approximations. Naturally, this documentation should only be used within a strictly legal framework. diff --git a/content/en/2.general/2.networking/3.samba.md b/content/en/2.general/2.networking/3.samba.md index 3ef7bf7..c900106 100644 --- a/content/en/2.general/2.networking/3.samba.md +++ b/content/en/2.general/2.networking/3.samba.md @@ -61,7 +61,7 @@ Then scroll to the end of the file and add the following configuration: ``` Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: ### Create a Samba User and Group @@ -111,7 +111,7 @@ sudo smbpasswd -a sambauser ```bash [Terminal] sudo smbpasswd -e sambauser ``` -### Done ! +### Done! :: ## Accessing a Shared Folder diff --git a/content/en/2.general/4.hardware/3.prolonas.md b/content/en/2.general/4.hardware/3.prolonas.md index d0c1599..e1f259d 100644 --- a/content/en/2.general/4.hardware/3.prolonas.md +++ b/content/en/2.general/4.hardware/3.prolonas.md @@ -12,13 +12,13 @@ This article was written before the __massive__ increase in computer hardware pr When you decide to dive into the adventure of running your own home server, the same questions usually come up: _“Where should I start?”_, _“Isn’t it expensive?”_. And often, people either give up or end up buying a proprietary NAS that they’ll throw away a year later once they realize it only brings headaches and wasted money. -A server isn’t a piece of furniture. It’s simply any computer capable of running Linux.That’s why mini PCs powered by **Intel N100** processors are so popular: for around $100–130 on Chinese platforms, you can get a machine that runs **24/7** for years, capable of handling everything you’d expect from a home server or personal cloud without sacrificing performance. +A server isn’t a piece of furniture. It’s simply any computer capable of running Linux. That’s why mini PCs powered by **Intel N100** processors are so popular: for around $100–130 on Chinese platforms, you can get a machine that runs **24/7** for years, capable of handling everything you’d expect from a home server or personal cloud without sacrificing performance. It’s **objectively inexpensive**, and anyone with a bit of curiosity can get started. A mini PC for $100 + a USB dock for $50 that holds multiple hard drives = a complete platform for $150, versus **$350–1200** for branded NAS systems. -That’s all a **ProloNAS** is. It’s then up to you to scale your storage capacity according to your needs. +That’s all a **ProloNAS** is: a NAS anyone can afford. The name is a French pun, *prolo* (slang for "working-class") plus *NAS*, a home server for the rest of us, not just people who can drop $1000 on a branded box. It’s then up to you to scale your storage capacity according to your needs. ![](/img/global/prolonas.svg) @@ -32,11 +32,11 @@ That’s all a **ProloNAS** is. It’s then up to you to scale your storage capa ## Why a NAS? -A **NAS** (Network Attached Storage) is a machine centered around storage, designed to be shared over a network.The idea is to have a **reliable and secure** storage space that serves as the backbone for your personal services and apps such as a self-hosted cloud like [Nextcloud](/serveex/cloud/nextcloud), a photo sync tool like [Immich](/serveex/cloud/immich), or a media server like [Jellyfin](/serveex/media/jellyfin). You can also store camera footage, backups, or even development projects on it. +A **NAS** (Network Attached Storage) is a machine centered around storage, designed to be shared over a network. The idea is to have a **reliable and secure** storage space that serves as the backbone for your personal services and apps such as a self-hosted cloud like [Nextcloud](/serveex/cloud/nextcloud), a photo sync tool like [Immich](/serveex/cloud/immich), or a media server like [Jellyfin](/serveex/media/jellyfin). You can also store camera footage, backups, or even development projects on it. ### But why not just use a mini PC with an external hard drive? -Sure, a simple mini PC with 1–2 TB of storage will do for most people.And your movie collection might fit on an external drive of a few extra terabytes. But that’s **neither reliable nor scalable** a single shock or hardware failure could permanently destroy your data. +Sure, a simple mini PC with 1–2 TB of storage will do for most people. And your movie collection might fit on an external drive of a few extra terabytes. But that’s **neither reliable nor scalable**: a single shock or hardware failure could permanently destroy your data. A real NAS is built around **storage reliability**. It uses redundancy strategies like [RAID](/general/storage/raid) to protect against drive failure, and snapshot systems like [ZFS](/general/storage/zfs) to guard against corruption. diff --git a/content/en/2.general/5.linux/1.cli-basics.md b/content/en/2.general/5.linux/1.cli-basics.md index 95c2e51..eeea6a9 100644 --- a/content/en/2.general/5.linux/1.cli-basics.md +++ b/content/en/2.general/5.linux/1.cli-basics.md @@ -32,7 +32,7 @@ Options change how a command behaves. They come in two flavours, and most comman - **Short**, a single dash and a single letter: `ls -a`. They can be stacked, so `ls -l -a -h` is usually written `ls -lah`. - **Long**, two dashes and a whole word: `ls --all`. Longer to type, but you can still tell what it does six months later, which is why they're the better choice in a script. -Some options expect a value right after them: `ssh-keygen -t ed25519` (`-t` for type), `rsync --exclude @eaDir`. And case matters, always. In `ls`, `-r` reverses the sort order while `-R` walks into subfolders. Two different things, one letter apart. +Some options expect a value right after them: `ssh-keygen -t ed25519` (`-t` for type), `rsync --exclude @eaDir`. And case matters, always. In `ls`, `-r` reverses the sort order while `-R` walks into subfolders. Same letter, different case. ### Arguments and paths diff --git a/content/en/2.general/5.linux/3.handy-tools.md b/content/en/2.general/5.linux/3.handy-tools.md index d44face..48d17dd 100644 --- a/content/en/2.general/5.linux/3.handy-tools.md +++ b/content/en/2.general/5.linux/3.handy-tools.md @@ -55,7 +55,7 @@ sudo btop Click a process to select it, :kbd{value="Esc"} opens the menu, :kbd{value="Q"} quits. The `+` and `-` keys fold and unfold the panels if the screen feels crowded. -#### Done ! +#### Done! :: ## `duf`, disk space that reads like a table @@ -79,7 +79,7 @@ sudo duf Local disks, network shares and system mounts are grouped separately. Add `--only local` to hide the pseudo-filesystems Docker leaves behind. -#### Done ! +#### Done! :: ## `ncdu`, finding what ate the disk @@ -105,7 +105,7 @@ Arrows to move, :kbd{value="Enter"} to open a folder, :kbd{value="D"} to delete :kbd{value="D"} deletes immediately, with a single confirmation and no recycle bin. Run `ncdu` without `sudo` when you're only looking, so a mistyped key can't touch anything the system owns. :: -#### Done ! +#### Done! :: ## `tldr`, the manual without the 400 lines @@ -133,7 +133,7 @@ The examples are fetched once and stored locally, so the command works offline a tldr rsync ``` -#### Done ! +#### Done! :: ## `lazydocker`, managing containers from the terminal @@ -198,7 +198,7 @@ The [full list](https://github.com/jesseduffield/lazydocker/blob/master/docs/key Being outside `apt` also means it won't be updated by `apt full-upgrade`. Repeat these steps when you want a newer version. :: -#### Done ! +#### Done! :: ## `ufw`, a firewall you can actually read @@ -257,6 +257,6 @@ To Action From 443/tcp ALLOW IN Anywhere ``` -#### Done ! +#### Done! :: diff --git a/content/en/3.serveex/2.core/1.installation.md b/content/en/3.serveex/2.core/1.installation.md index d31b291..3eddd07 100644 --- a/content/en/3.serveex/2.core/1.installation.md +++ b/content/en/3.serveex/2.core/1.installation.md @@ -8,7 +8,7 @@ description: Step-by-step guide to install Debian 13 on a home server and set up [Debian 13 "Trixie"](https://www.debian.org/) is the base this whole guide sits on. It's a plain, boring, stable Linux, and for a homelab that's exactly the point: package versions stay frozen for the life of the release, security patches keep coming for about five years counting LTS, so the machine keeps running for years instead of needing a rebuild every few months. -The other reason is that it stays out of your way. Appliance systems like Unraid, TrueNAS or Synology's DSM put their own layer on top of Docker, and the day you need something their interface doesn't expose, you're stuck working around it. Debian is just a server: you install what you want, where you want, and nothing is hidden behind someone else's UI. It also happens to be what most self-hosted projects target first, so their docs hand you `apt` commands that work as-is, Docker publishes an official Debian repository, and any error message you paste into a search engine already has years of answers behind it. A minimal install is light enough to leave nearly all the RAM and CPU of a small N100 box to your containers. +The other reason is that it stays out of your way. Appliance systems like Unraid, TrueNAS or Synology's DSM put their own layer on top of Linux, and the day you need something their interface doesn't expose, you're stuck working around it. Debian is just a server: you install what you want, where you want, and nothing is hidden behind someone else's UI. It also happens to be what most self-hosted projects target first, so their docs hand you `apt` commands that work as-is, Docker publishes an official Debian repository, and any error message you paste into a search engine already has years of answers behind it. A minimal install is light enough to leave nearly all the RAM and CPU of a small N100 box to your containers. ![picture](/img/serveex/server.svg) @@ -55,7 +55,7 @@ _Screenshot from [this bootable USB guide on DEV Community](https://dev.to/devop Writing takes a few minutes. -#### Done ! +#### Done! :: ### Install Debian @@ -117,7 +117,7 @@ Install it on the disk you just partitioned (`/dev/sda`, `/dev/nvme0n1`...), not ![Debian installer asking which device to install the GRUB boot loader to](/img/serveex/install/debian-install-grub.png) -#### Done ! +#### Done! :: ::note @@ -209,7 +209,7 @@ Keep your current SSH session open while you test. Open a **second** terminal an The door is now closed for every other machine too, including the next one you'll want to connect from. To let a new one in, set `PasswordAuthentication yes` back in `hardening.conf`, restart SSH, run the two key steps above from that machine, then set it to `no` again and restart SSH one last time. :: -#### Done ! +#### Done! :: ### Wake the server up remotely @@ -278,7 +278,7 @@ wakeonlan aa:bb:cc:dd:ee:ff Windows has no built-in sender, so the simplest route there is a phone app: any of the free *Wake on LAN* apps takes the MAC address and works the same way. The server should start within a couple of seconds. -#### Done ! +#### Done! :: ::note @@ -322,7 +322,7 @@ sudo reboot A kernel or libc update only takes effect after a restart. Everything else applies immediately, so this is only needed when the upgrade touched one of those, and it's worth planning for a moment when nothing depends on the machine. -#### Done ! +#### Done! :: ::tip diff --git a/content/en/3.serveex/2.core/2.docker.md b/content/en/3.serveex/2.core/2.docker.md index 84cbba7..14042f0 100644 --- a/content/en/3.serveex/2.core/2.docker.md +++ b/content/en/3.serveex/2.core/2.docker.md @@ -37,7 +37,7 @@ sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin ``` -### Done ! +### Done! :: **More options:** [Install Docker for Debian 13](https://docs.docker.com/engine/install/debian/) @@ -153,7 +153,7 @@ Then go to `http://yourserverip:3555` in your browser to access the login page. More info on [Dockge and how to use it](https://github.com/louislam/dockge) -#### Done ! +#### Done! :: And there you go! Docker and a tool to easily manage your containers are ready! @@ -264,7 +264,7 @@ services: Then restart the modified stacks. -#### Done ! +#### Done! :: And that's it! You now have a solid base to start deploying the services you want! diff --git a/content/en/3.serveex/2.core/3.wireguard.md b/content/en/3.serveex/2.core/3.wireguard.md index 12266bc..63f9db0 100644 --- a/content/en/3.serveex/2.core/3.wireguard.md +++ b/content/en/3.serveex/2.core/3.wireguard.md @@ -150,7 +150,7 @@ Then go to *Administrator → Admin Panel → Config*: - Change `Allowed IPs` from the default `0.0.0.0/0` (full tunnel) to `10.8.0.0/24` for **split tunneling**. - Optionally remove the IPv6 entry from `Allowed IPs` if you don't want client IPv6 traffic routed through the tunnel. This only affects what clients tunnel, not the container's own IPv6 setup above. -### Done ! +### Done! :: ### Retrieve Configuration Files @@ -176,7 +176,7 @@ Set it to `25` if it’s a permanently connected client. Save, download, and rename the file to `wg0.conf` (or `wg1.conf`, etc.) -#### Done ! +#### Done! :: ## Client Server Setup @@ -255,7 +255,7 @@ cd /srv/docker/wireguard sudo docker compose up -d ``` -### Done ! +### Done! :: ::note diff --git a/content/en/3.serveex/2.core/4.swag.md b/content/en/3.serveex/2.core/4.swag.md index e5ccb26..c17fd9a 100644 --- a/content/en/3.serveex/2.core/4.swag.md +++ b/content/en/3.serveex/2.core/4.swag.md @@ -175,7 +175,7 @@ include /config/nginx/dbip.conf; Restart the stack in Dockge. This time, the SSL certificate should be successfully generated! Check the logs to confirm the server is ready. -### Done ! +### Done! :: ## Dashboard @@ -250,7 +250,7 @@ geo $lan-ip { Save and close the file, then restart the stack. -### Done ! +### Done! :: In the domain config files (see next section), you can enable or disable the whitelist or blacklist ([see documentation here](https://www.forum-nas.fr/threads/tuto-installer-swag-en-docker-reverse-proxy.15057/)). In our case, the whitelist allows only French requests. The blacklist blocks only the listed countries. We'll use the blacklist, like so: @@ -383,7 +383,7 @@ Redeploy the SWAG stack. Wait a moment, then visit `https://dockge.mydomain.com` in your browser. You should be redirected to Dockge. You can also check the service status from the dashboard (`http://yourserverip:81` on your local network). -### Done ! +### Done! :: ## Exposing Another Service with SWAG diff --git a/content/en/3.serveex/3.security/2.cloudflare.md b/content/en/3.serveex/3.security/2.cloudflare.md index deb2fa8..9e5edec 100644 --- a/content/en/3.serveex/3.security/2.cloudflare.md +++ b/content/en/3.serveex/3.security/2.cloudflare.md @@ -220,7 +220,7 @@ Then confirm your tunnel appears under _Networks > Tunnels_ in [Cloudflare Zero ![dns](/img/serveex/cf-dns.png) :: -### Done ! +### Done! :: ## Managing Multiple Tunnels for Multiple Servers @@ -246,7 +246,7 @@ In the [Cloudflare DNS dashboard](https://dash.cloudflare.com/), click your doma | `CNAME` | `subdomain1` | `yourtunnelid1.cfargotunnel.com` | | `CNAME` | `subdomain2` | `yourtunnelid2.cfargotunnel.com` | -### Done ! +### Done! :: If you have many subdomains, point them to the above reference subdomains. diff --git a/content/en/3.serveex/3.security/3.tinyauth.md b/content/en/3.serveex/3.security/3.tinyauth.md index 003850c..2882fc6 100644 --- a/content/en/3.serveex/3.security/3.tinyauth.md +++ b/content/en/3.serveex/3.security/3.tinyauth.md @@ -96,7 +96,7 @@ TINYAUTH_AUTH_USERS= Deploy the stack. The local interface is available at `http://yourserverip:3002`. -### Done ! +### Done! :: ## Enabling Two-Factor Authentication @@ -130,7 +130,7 @@ sudo docker run -i -t --rm ghcr.io/tinyauthapp/tinyauth:v5 user verify --interac It re-prompts for the username, password, and current 6-digit code. :: -### Done ! +### Done! :: From now on, that user needs both their password and a valid code from their authenticator app to log in. @@ -221,7 +221,7 @@ Wait a few minutes, then open `https://tinyauth.mydomain.com` in your browser an __If it fails:__ check your firewall rules. :: -### Done ! +### Done! :: ## Protecting an app via reverse proxy @@ -284,7 +284,7 @@ The `location /tinyauth` block runs inside SWAG's own container, so SWAG needs t Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: That's it! Visiting `https://dockge.mydomain.com` now redirects to TinyAuth first. Repeat this `location /tinyauth` / `auth_request` pattern in any other app's `*.subdomain.conf` to protect it the same way. diff --git a/content/en/3.serveex/3.security/4.pocket-id.md b/content/en/3.serveex/3.security/4.pocket-id.md index 1221214..e730788 100644 --- a/content/en/3.serveex/3.security/4.pocket-id.md +++ b/content/en/3.serveex/3.security/4.pocket-id.md @@ -100,7 +100,7 @@ TRUST_PROXY=true Deploy the stack. The local interface is available at `http://yourserverip:1411`. -### Done ! +### Done! :: ## First login @@ -205,7 +205,7 @@ Wait a few minutes, then open `https://id.mydomain.com` in your browser. __If it fails:__ check your firewall rules. :: -### Done ! +### Done! :: ## Registering an OIDC client @@ -224,7 +224,7 @@ Go to _Administration > OIDC Clients_, then click _Add OIDC Client_. Fill in a n Save, then copy the generated __Client ID__ and __Client Secret__. You'll need them in the other app's configuration. -### Done ! +### Done! :: ## Connecting Pocket ID to TinyAuth @@ -276,7 +276,7 @@ Redeploy the TinyAuth stack. On your next visit to `https://tinyauth.mydomain.co ✨ To skip straight to Pocket ID and hide the local login form, add `TINYAUTH_OAUTH_AUTOREDIRECT=pocketid` to the same `.env` file. :: -### Done ! +### Done! :: That's it! TinyAuth now offers passwordless login via Pocket ID for every app it protects. diff --git a/content/en/3.serveex/4.monitoring/1.uptime-kuma.md b/content/en/3.serveex/4.monitoring/1.uptime-kuma.md index 5fff270..132fb1d 100644 --- a/content/en/3.serveex/4.monitoring/1.uptime-kuma.md +++ b/content/en/3.serveex/4.monitoring/1.uptime-kuma.md @@ -62,7 +62,7 @@ You can now access the tool via `http://yourserverip:3200`. __If it fails:__ check your firewall rules. :: -### Done ! +### Done! :: ## Expose with Swag @@ -173,7 +173,7 @@ Restart the stack and wait until SWAG is fully operational. Here we assume that the network name of Uptime-Kuma is `uptime-kuma_default`. You can verify the connection by visiting SWAG's dashboard at `http://yourserverip:81`. :: -### Done ! +### Done! :: That's it! Uptime-Kuma is now exposed, and you can access it via `https://stats.mydomain.com`. @@ -245,7 +245,7 @@ The `location /tinyauth` block runs inside SWAG's own container, so SWAG needs t Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: Redeploy the stack. Uptime-Kuma will then be publicly reachable via `https://stats.mydomain.com`, with the status page open and everything else behind TinyAuth. diff --git a/content/en/3.serveex/4.monitoring/2.dozzle.md b/content/en/3.serveex/4.monitoring/2.dozzle.md index 77c227c..4754b68 100644 --- a/content/en/3.serveex/4.monitoring/2.dozzle.md +++ b/content/en/3.serveex/4.monitoring/2.dozzle.md @@ -101,7 +101,7 @@ DOMAIN=dozzle.mydomain.com Deploy the container. Go to `http://yourserverip:9135`. Voilà, your Dozzle web UI is up and running! -### Done ! +### Done! :: ## Exposing Dozzle with Swag @@ -214,7 +214,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: And there you go, Dozzle is now exposed! diff --git a/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md b/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md index 1b8b43e..ac0a37c 100644 --- a/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md +++ b/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md @@ -89,7 +89,7 @@ PORT=3225 # port to access the web UI Deploy the container and go to `http://yourserverip:3225`. Log in with the account `admin@exemple.com` and the password `password`. Don’t forget to change your ID and password once logged in! -### Done ! +### Done! :: ## Exposing Speedtest Tracker with SWAG @@ -194,7 +194,7 @@ Restart the stack by clicking "Deploy" and wait for SWAG to be fully up. This assumes the Speedtest Tracker network is named `speedtest-tracker_default`. You can verify the connection by visiting SWAG’s dashboard at `http://yourserverip:81`. :: -### Done ! +### Done! :: Wait a moment, then visit `https://speedtest.yourdomain.com` in your browser. You should be redirected to Speedtest Tracker. You can check service status via the dashboard (`http://yourserverip:81` from the local network). diff --git a/content/en/3.serveex/4.monitoring/4.beszel.md b/content/en/3.serveex/4.monitoring/4.beszel.md index b97ba90..b70f39c 100644 --- a/content/en/3.serveex/4.monitoring/4.beszel.md +++ b/content/en/3.serveex/4.monitoring/4.beszel.md @@ -108,7 +108,7 @@ For the `KEY` value, you'll need to launch Beszel once to get it. Deploy the container and go to `http://yourserverip:8090`. Your Beszel web UI is now accessible! -### Done ! +### Done! :: ::caution @@ -286,7 +286,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: That’s it! Beszel is now exposed! diff --git a/content/en/3.serveex/4.monitoring/5.upsnap.md b/content/en/3.serveex/4.monitoring/5.upsnap.md index a6c8537..c50bed6 100644 --- a/content/en/3.serveex/4.monitoring/5.upsnap.md +++ b/content/en/3.serveex/4.monitoring/5.upsnap.md @@ -77,7 +77,7 @@ DNS=192.168.1.1 # DNS IP to resolve domain names, typically your router’s IP Deploy the container and go to `http://yourserverip:8095`. Just follow the steps to create your account! -### Done ! +### Done! :: ::caution @@ -195,7 +195,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: And that’s it! You’ve exposed UpSnap! diff --git a/content/en/3.serveex/5.media/1.jellyfin.md b/content/en/3.serveex/5.media/1.jellyfin.md index 63b5a32..07a4a1e 100644 --- a/content/en/3.serveex/5.media/1.jellyfin.md +++ b/content/en/3.serveex/5.media/1.jellyfin.md @@ -106,7 +106,7 @@ Deploy the stack. The local interface is available at `http://yourserverip:8096` The `/dev/dri` device is only needed for hardware-accelerated transcoding on Intel/AMD GPUs. Remove it if your server doesn't have one, or adapt it for an NVIDIA GPU following **linuxserver.io's documentation**. :: -### Done ! +### Done! :: ## Configure Jellyfin @@ -160,7 +160,7 @@ Then uncheck any codec your specific GPU doesn't support hardware-decode for. [I Further down the same page, enable **Tone mapping**. This only takes effect once the OpenCL mod above is installed and the stack redeployed; enabling it without that step first will make HDR transcodes fail instead of just skipping the tone mapping. -### Done ! +### Done! :: ## Watching at Home @@ -229,7 +229,7 @@ Replace `10.8.0.2` with whatever address your server actually got. Leaving the d A `.conf` file is a credential, not just a settings file: whoever has it can connect to your VPN as that device. Once it's imported, delete it from the USB drive (and anywhere else you copied it, like Downloads folders), and never share it with anyone else. :: -### Done ! +### Done! :: ### Restricting a third-party peer to just Jellyfin @@ -258,7 +258,7 @@ docker exec wg-easy iptables -L WG_CLIENTS -n -v You should see an `ACCEPT` line for that peer's IP pointing only at your Jellyfin server, followed by a catch-all `DROP`. -#### Done ! +#### Done! :: Once connected, open the Jellyfin app or `http://10.8.0.2:8096` (your server's VPN address) from that device. Only traffic to that address goes through the VPN; the rest of the device's connection is untouched. diff --git a/content/en/3.serveex/5.media/2.qbittorrent.md b/content/en/3.serveex/5.media/2.qbittorrent.md index 50a5df3..e98c733 100644 --- a/content/en/3.serveex/5.media/2.qbittorrent.md +++ b/content/en/3.serveex/5.media/2.qbittorrent.md @@ -184,7 +184,7 @@ Detailed info: | `ID` | Qbittorrent UI login username | `user` | | `PW` | Qbittorrent UI password | `password` | -### Done ! +### Done! :: ## Deployment @@ -214,7 +214,7 @@ __If login fails:__ check your firewall rules. Change your username and password in the "webui" settings. -### Done ! +### Done! :: You're done! In Qbittorrent settings, under "Downloads", set `/media/downloads` as the default folder. @@ -331,7 +331,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: Wait a few minutes, then go to `https://seedbox.mydomain.com`. You should land on the Qbittorrent interface. diff --git a/content/en/3.serveex/5.media/3.servarr.md b/content/en/3.serveex/5.media/3.servarr.md index 79f97e1..246207b 100644 --- a/content/en/3.serveex/5.media/3.servarr.md +++ b/content/en/3.serveex/5.media/3.servarr.md @@ -183,7 +183,7 @@ sudo chown -R 1000:1000 /srv/docker/seerr/config Deploy the stack. -### Done ! +### Done! :: ### Configure Radarr @@ -240,7 +240,7 @@ Then, in Radarr, go to *Settings > Connect*, add a new connection and choose *Je - Go to *Settings > General* and copy your *API Key* for later use. -#### Done ! +#### Done! :: ### Configure Sonarr @@ -280,7 +280,7 @@ In *Settings > Apps*, add Radarr and Sonarr with the following details: - API Key: use the one copied from Radarr and Sonarr. - Click *Test*, then *Save* if all goes well. -#### Done ! +#### Done! :: ### Configuring Bazarr @@ -325,7 +325,7 @@ Go to *Settings > General* and create a username and password using *forms login Repeat the same steps for Radarr. -#### Done ! +#### Done! :: ### Configuring Seerr @@ -378,7 +378,7 @@ If the test succeeds, continue filling in the fields: - Check all 4 boxes at the bottom. - Save and continue. -#### Done ! +#### Done! :: And that’s it! Just request a movie or series, then check in qBittorrent or Radarr/Sonarr. Within a few minutes, your media will be available on Jellyfin! @@ -503,7 +503,7 @@ Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ct Wait a few minutes, then visit `http://films.mydomain.com` in your browser. -### Done ! +### Done! :: ::caution diff --git a/content/en/3.serveex/6.cloud/1.immich.md b/content/en/3.serveex/6.cloud/1.immich.md index 5f5a8b6..874184c 100644 --- a/content/en/3.serveex/6.cloud/1.immich.md +++ b/content/en/3.serveex/6.cloud/1.immich.md @@ -50,7 +50,7 @@ If you're using a NAS or a network-shared drive via **Samba** to store your data Deploy the container. You can connect and follow the setup instructions at `http://yourserverip:2283`. -### Done ! +### Done! :: ## Exposing Immich with SWAG @@ -166,7 +166,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: That's it! Immich is now accessible from the internet. Don’t forget to install the [iOS](https://apps.apple.com/us/app/immich/id1613945652) / [Android](https://play.google.com/store/apps/details?id=app.alextran.immich) apps to sync your devices. @@ -197,7 +197,7 @@ In Immich, go to _Administration > Settings > Authentication Settings > OAuth_, | Client ID | The client ID copied from Pocket ID | | Client Secret | The client secret copied from Pocket ID | -### Done ! +### Done! :: ::tip{icon="" to="/serveex/advanced/authentik"} diff --git a/content/en/3.serveex/6.cloud/2.nextcloud.md b/content/en/3.serveex/6.cloud/2.nextcloud.md index 6d241cc..2daebaa 100644 --- a/content/en/3.serveex/6.cloud/2.nextcloud.md +++ b/content/en/3.serveex/6.cloud/2.nextcloud.md @@ -76,7 +76,7 @@ PORT=4545 Deploy the stack and visit `http://yourserverip:4545` to complete the setup. -### Done ! +### Done! :: ::caution @@ -197,7 +197,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: That’s it! You’ve exposed Nextcloud! Don’t forget to install [the desktop and mobile apps](https://nextcloud.com/install/). @@ -230,7 +230,7 @@ In Nextcloud, go to _Administration > OpenID Connect_, click the `+` button, and | Discovery endpoint | Pocket ID's OIDC discovery URL | | Scope | `openid email profile groups` | -### Done ! +### Done! :: ::tip{icon="" to="/serveex/advanced/authentik"} diff --git a/content/en/3.serveex/7.files/1.file-browser-quantum.md b/content/en/3.serveex/7.files/1.file-browser-quantum.md index 046f906..aa6401a 100644 --- a/content/en/3.serveex/7.files/1.file-browser-quantum.md +++ b/content/en/3.serveex/7.files/1.file-browser-quantum.md @@ -96,7 +96,7 @@ Mount every folder you listed under `sources` in `config.yaml` at the same path Deploy the container and go to `http://yourserverip:8020`. Log in with the default `admin` / `admin` credentials, then immediately change the password in your profile settings. -### Done ! +### Done! :: ::caution @@ -205,7 +205,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: That's it! File Browser Quantum is now exposed. diff --git a/content/en/3.serveex/7.files/2.pingvin.md b/content/en/3.serveex/7.files/2.pingvin.md index 11d0cbf..184a931 100644 --- a/content/en/3.serveex/7.files/2.pingvin.md +++ b/content/en/3.serveex/7.files/2.pingvin.md @@ -66,7 +66,7 @@ From here on, we assume the network name for Swag is `swag_default`. Deploy the container and go to `http://yourserverip:3600`. That's it! Your Pingvin web UI instance is up and running! -### Done ! +### Done! :: ::caution @@ -179,7 +179,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: That's it, you've exposed Pingvin! @@ -206,7 +206,7 @@ In Pingvin, go to _Administration > Configuration > Social Login_ and fill in: | Discovery URI | Pocket ID's OIDC discovery URL | | Scope | `openid email profile groups` | -### Done ! +### Done! :: That's it! From now on, when you log in to Pingvin, an "Open ID" button will be available below the login form. @@ -247,7 +247,7 @@ Leave Authentik, and go to Pingvin's admin interface. In the _"OAuth"_ section, - `OpenID client ID` with the ID you copied in step 2. - `OpenID client secret` with the token you copied in step 2. -#### Done ! +#### Done! :: ::: diff --git a/content/en/3.serveex/8.development/1.code-server.md b/content/en/3.serveex/8.development/1.code-server.md index 26cad0e..2020ca4 100644 --- a/content/en/3.serveex/8.development/1.code-server.md +++ b/content/en/3.serveex/8.development/1.code-server.md @@ -97,7 +97,7 @@ __Note:__ Make sure to wrap the hash in single quotes `'` Deploy the container and go to `http://yourserverip:8443`. Voilà, your code-server instance is up and running in the browser! -### Done ! +### Done! :: ::caution @@ -221,7 +221,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: That’s it! code-server is now exposed! diff --git a/content/en/3.serveex/8.development/2.forgejo.md b/content/en/3.serveex/8.development/2.forgejo.md index cadcb6e..408a645 100644 --- a/content/en/3.serveex/8.development/2.forgejo.md +++ b/content/en/3.serveex/8.development/2.forgejo.md @@ -65,7 +65,7 @@ GID=1000 Deploy the container and go to `http://yourserverip:3333`. Your Forgejo instance is now up and running! -### Done ! +### Done! :: ::caution @@ -201,7 +201,7 @@ ROOT_URL = https://forgejo.yourdomain.com/ Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit, then restart the container. -### Done ! +### Done! :: And that’s it! Forgejo is now exposed to the web. @@ -238,7 +238,7 @@ As an admin, go to _Site Administration > Identity & Access > Authentication Sou Also enable __Skip local 2FA__. -### Done ! +### Done! :: ::tip{icon="" to="/serveex/advanced/authentik"} diff --git a/content/en/3.serveex/8.development/3.it-tools.md b/content/en/3.serveex/8.development/3.it-tools.md index c383806..7136a46 100644 --- a/content/en/3.serveex/8.development/3.it-tools.md +++ b/content/en/3.serveex/8.development/3.it-tools.md @@ -43,7 +43,7 @@ services: Deploy the container and visit `http://yourserverip:3222`. That’s it, your IT Tools web UI instance is up and running! -### Done ! +### Done! :: ::caution @@ -160,7 +160,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: And that’s it! IT Tools is now exposed! diff --git a/content/en/3.serveex/9.apps/1.adguard.md b/content/en/3.serveex/9.apps/1.adguard.md index 4b0d50b..a920564 100644 --- a/content/en/3.serveex/9.apps/1.adguard.md +++ b/content/en/3.serveex/9.apps/1.adguard.md @@ -99,7 +99,7 @@ Go to `http://yourserverip:3000` and follow the setup instructions. The setup wizard asks you to pick an admin interface port. Keep it at `3000`: the SWAG configuration further down assumes the admin interface stays on that port, and changing it here would make exposing AdGuard with SWAG fail with a 502 error. :: -### Done ! +### Done! :: That’s it! Adguard is deployed. @@ -236,7 +236,7 @@ server { } ``` -### Done ! +### Done! :: ## Protecting AdGuard with TinyAuth diff --git a/content/en/3.serveex/9.apps/2.vaultwarden.md b/content/en/3.serveex/9.apps/2.vaultwarden.md index f896236..6693e4d 100644 --- a/content/en/3.serveex/9.apps/2.vaultwarden.md +++ b/content/en/3.serveex/9.apps/2.vaultwarden.md @@ -100,7 +100,7 @@ Then deploy the container. Recently, Vaultwarden requires SSL to be accessed, which prevents access via a local IP. We'll expose it with SWAG, which provides an SSL certificate. -### Done ! +### Done! :: ::caution @@ -244,7 +244,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: And there you go! Vaultwarden is now exposed! Visit `https://vault.yourdomain.com/admin` to access the admin panel and paste the password you specified when generatique the `ADMIN_TOKEN`. For more information, see the [Bitwarden documentation](https://bitwarden.com/help/). @@ -298,7 +298,7 @@ Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ct Redeploy Vaultwarden. Your next visit to `https://vault.yourdomain.com` will prompt for SSO login instead of (or alongside) the local master password. -### Done ! +### Done! :: ::note{to="https://github.com/dani-garcia/vaultwarden/wiki/Enabling-SSO-support-using-OpenId-Connect"} @@ -329,7 +329,7 @@ SSO_CLIENT_SECRET= SSO_SCOPES=email profile offline_access ``` -#### Done ! +#### Done! :: ::: diff --git a/content/en/3.serveex/91.advanced/1.authentik.md b/content/en/3.serveex/91.advanced/1.authentik.md index 99d2484..d7ad2c5 100644 --- a/content/en/3.serveex/91.advanced/1.authentik.md +++ b/content/en/3.serveex/91.advanced/1.authentik.md @@ -229,7 +229,7 @@ You can then begin the initial setup by visiting: __Warning:__ It’s recommended to create a new admin account and **disable** the default `akadmin` account. :: -### Done ! +### Done! :: ## Exposing Authentik @@ -333,7 +333,7 @@ networks: # Define the custom network Restart the stack and wait for SWAG to be fully operational. -### Done ! +### Done! :: You can now access Authentik via `https://auth.mydomain.com` @@ -350,7 +350,7 @@ Go to `https://auth.mydomain.com` and log in. Go to _Settings_, click the _MFA_ section, then _Register_. Choose a method like _TOTP device_ (you'll need an authenticator app like Google Authenticator) and follow the steps. -### Done ! +### Done! :: You’ll now be prompted to enter a one-time code at every login. @@ -402,7 +402,7 @@ Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ct ✨ __Tip:__ In Dockge's settings, you can disable Dockge's authentication to avoid double login. **Warning**: this means if the port is open on your local network, there will be no authentication at all. :: -### Done ! +### Done! :: Now when accessing `https://dockge.mydomain.com`, you’ll be redirected to the Authentik login screen. @@ -616,7 +616,7 @@ proxy_pass http://$upstream_authentik:9000; Save with :kbd{value="Ctrl+O"}, then :kbd{value="Enter"}, and exit with :kbd{value="Ctrl+X"}. -### Done ! +### Done! :: Then configure the applications to protect as you did on your main server, whether they are [native](/serveex/advanced/authentik/#protecting-a-native-app) or protected via [reverse proxy](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy). @@ -661,5 +661,5 @@ Restore the database: sudo docker exec authentik-postgresql pg_restore -U authentik -d authentik /path/to/wherever/mydb.tar ``` -### Done ! +### Done! :: diff --git a/content/en/3.serveex/91.advanced/2.arcane.md b/content/en/3.serveex/91.advanced/2.arcane.md index 8f5b29c..9126cbc 100644 --- a/content/en/3.serveex/91.advanced/2.arcane.md +++ b/content/en/3.serveex/91.advanced/2.arcane.md @@ -142,7 +142,7 @@ PGID=1000 Deploy the stack. The local interface is available at `http://yourserverip:3552`. -### Done ! +### Done! :: ::caution @@ -240,7 +240,7 @@ Arcane's live updates run over a websocket, hence the `Upgrade`/`Connection` hea Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: That's it! Arcane is now accessible from the internet. @@ -290,7 +290,7 @@ Deploy the stack. Back in Arcane, the new environment should show as connected within a few seconds. Switch to it from the environment picker to manage that host's containers and stacks. -### Done ! +### Done! :: ## Connecting Pocket ID @@ -330,7 +330,7 @@ Redeploy the stack. ✨ To skip straight to Pocket ID and hide the local login form, set `OIDC_AUTO_REDIRECT_TO_PROVIDER=true`, or disable local login entirely under _Settings > Authentication_ for OIDC-only access. :: -### Done ! +### Done! :: That's it! Arcane now offers a "Login with Pocket ID" option alongside the local login form. diff --git a/content/en/5.nonsense/3.bash/6.rm-confirmation.md b/content/en/5.nonsense/3.bash/6.rm-confirmation.md index 6f7c59c..2c9dde0 100644 --- a/content/en/5.nonsense/3.bash/6.rm-confirmation.md +++ b/content/en/5.nonsense/3.bash/6.rm-confirmation.md @@ -64,7 +64,7 @@ Deletion cancelled. Answer `y` and it runs for real. Anything that isn't `rm`, `sudo apt update`, `sudo systemctl restart docker`, goes through without a prompt. -### Done ! +### Done! :: ::note diff --git a/content/en/6.recycled/2.deprecated/1.wireguard-14.md b/content/en/6.recycled/2.deprecated/1.wireguard-14.md index b6d99f4..e96e109 100644 --- a/content/en/6.recycled/2.deprecated/1.wireguard-14.md +++ b/content/en/6.recycled/2.deprecated/1.wireguard-14.md @@ -140,7 +140,7 @@ IPS= Deploy the stack. -### Done ! +### Done! :: ### Enable Forwarding on Host @@ -252,7 +252,7 @@ sudo docker compose up -d Repeat for each client :: -### Done ! +### Done! :: ## Other Devices diff --git a/content/en/6.recycled/2.deprecated/2.file-browser.md b/content/en/6.recycled/2.deprecated/2.file-browser.md index e7806e2..9308c54 100644 --- a/content/en/6.recycled/2.deprecated/2.file-browser.md +++ b/content/en/6.recycled/2.deprecated/2.file-browser.md @@ -50,7 +50,7 @@ services: Deploy the container and go to `http://yourserverip:8010`. That’s it! Your File Browser web UI is up and running! -### Done ! +### Done! :: ::caution @@ -163,7 +163,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: That’s it! File Browser is now exposed! diff --git a/content/en/6.recycled/3.alternatives/1.plex.md b/content/en/6.recycled/3.alternatives/1.plex.md index 0526c7a..b650a22 100644 --- a/content/en/6.recycled/3.alternatives/1.plex.md +++ b/content/en/6.recycled/3.alternatives/1.plex.md @@ -142,7 +142,7 @@ Tautulli is accessible at `http://yourserverip:8181`. You must be on your local network during Plex's initial setup. Otherwise, the URL will redirect to your Plex account without detecting your server. A VPN won't help. If you have no choice, **you can handle the setup remotely via SSH tunnel**. :: -### Done ! +### Done! :: ## Configure Plex @@ -312,7 +312,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: Wait a few minutes, then open `http://tautulli.mydomain.com` in your browser. diff --git a/content/en/6.recycled/3.alternatives/2.qbittorrent for plex.md b/content/en/6.recycled/3.alternatives/2.qbittorrent for plex.md index d48a5e4..80b8e57 100644 --- a/content/en/6.recycled/3.alternatives/2.qbittorrent for plex.md +++ b/content/en/6.recycled/3.alternatives/2.qbittorrent for plex.md @@ -189,7 +189,7 @@ Detailed info: | `ID` | Qbittorrent UI login username | `user` | | `PW` | Qbittorrent UI password | `password` | -### Done ! +### Done! :: ## Deployment @@ -215,7 +215,7 @@ __If login fails:__ check your firewall rules. Change your username and password in the "webui" settings. -### Done ! +### Done! :: You're done! In Qbittorrent settings, under "Downloads", set `/media/downloads` as the default folder. @@ -336,7 +336,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: Wait a few minutes, then go to `https://seedbox.mydomain.com`. You should land on the Qbittorrent interface. diff --git a/content/en/6.recycled/3.alternatives/3.servarr for plex.md b/content/en/6.recycled/3.alternatives/3.servarr for plex.md index 5c88410..cdb17f5 100644 --- a/content/en/6.recycled/3.alternatives/3.servarr for plex.md +++ b/content/en/6.recycled/3.alternatives/3.servarr for plex.md @@ -209,7 +209,7 @@ MEDIA_PATH= Deploy the stack. -### Done ! +### Done! :: ### Configure Radarr @@ -264,7 +264,7 @@ Go to *Settings > Connect*, add a new connection and choose *Plex Media Server*. - Go to *Settings > General* and copy your *API Key* for later use. -#### Done ! +#### Done! :: ### Configure Sonarr @@ -304,7 +304,7 @@ In *Settings > Apps*, add Radarr and Sonarr with the following details: - API Key: use the one copied from Radarr and Sonarr. - Click *Test*, then *Save* if all goes well. -#### Done ! +#### Done! :: ### Configuring Bazarr @@ -349,7 +349,7 @@ Go to *Settings > General* and create a username and password using *forms login Repeat the same steps for Radarr. -#### Done ! +#### Done! :: ### Configuring Overseerr @@ -404,7 +404,7 @@ If the test succeeds, continue filling in the fields: - Check all 4 boxes at the bottom. - Save and continue. -#### Done ! +#### Done! :: And that’s it! Just request a movie or series, then check in qBittorrent or Radarr/Sonarr. Within a few minutes, your media will be available on Plex! @@ -522,7 +522,7 @@ server { Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit. -### Done ! +### Done! :: Wait a few minutes, then visit `http://films.mydomain.com` in your browser. diff --git a/content/en/6.recycled/3.alternatives/4.gitea.md b/content/en/6.recycled/3.alternatives/4.gitea.md index 5de0110..186f55b 100644 --- a/content/en/6.recycled/3.alternatives/4.gitea.md +++ b/content/en/6.recycled/3.alternatives/4.gitea.md @@ -67,7 +67,7 @@ GID=1000 Deploy the container and go to `http://yourserverip:3333`. Your Gitea instance is now up and running! -### Done ! +### Done! :: ::caution @@ -203,7 +203,7 @@ ROOT_URL = https://gitea.yourdomain.com/ Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit, then restart the container. -### Done ! +### Done! :: And that’s it! Gitea is now exposed to the web. -- 2.54.0 From a4c386e43812c33e6fc1cd7b7588e068203dd686 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 13:49:53 +0200 Subject: [PATCH 15/20] Fix ZFS RAID note to use a clickable card, standardize FR terminal blocks on [Output] instead of [Sortie] --- content/fr/2.general/3.storage/2.zfs.md | 4 ++-- content/fr/2.general/5.linux/1.cli-basics.md | 16 ++++++++-------- content/fr/2.general/5.linux/3.handy-tools.md | 2 +- 3 files changed, 11 insertions(+), 11 deletions(-) diff --git a/content/fr/2.general/3.storage/2.zfs.md b/content/fr/2.general/3.storage/2.zfs.md index f7d3196..15d1fcb 100644 --- a/content/fr/2.general/3.storage/2.zfs.md +++ b/content/fr/2.general/3.storage/2.zfs.md @@ -54,9 +54,9 @@ ZFS propose son propre système de gestion de volumes (vdev). Vous pouvez créer ZFS gère cela directement, pas besoin de logiciel RAID externe. -::note +::note{to="/general/storage/raid"} -Consultez [l'article sur le RAID](/general/storage/raid) pour en savoir plus sur la solution qui vous convient. +Consultez l'**article sur le RAID** pour en savoir plus sur la solution qui vous convient. :: ### Snapshots et clones diff --git a/content/fr/2.general/5.linux/1.cli-basics.md b/content/fr/2.general/5.linux/1.cli-basics.md index ae3669f..3e6aee8 100644 --- a/content/fr/2.general/5.linux/1.cli-basics.md +++ b/content/fr/2.general/5.linux/1.cli-basics.md @@ -83,7 +83,7 @@ Vous dit où vous êtes. Elle ne change rien, elle répond juste à la question. pwd ``` -```console [Sortie] +```console [Output] /home/utilisateur/docker ``` @@ -95,7 +95,7 @@ Liste ce qu'il y a dans le dossier courant. Seule, elle n'affiche que les noms, ls -lah ``` -```console [Sortie] +```console [Output] total 20K drwxr-xr-x 4 utilisateur utilisateur 4.0K Sep 5 10:12 . drwxr-xr-x 18 utilisateur utilisateur 4.0K Sep 4 21:03 .. @@ -128,7 +128,7 @@ mkdir sauvegardes mkdir -p docker/immich/config ``` -```console [Sortie] +```console [Output] ``` @@ -145,7 +145,7 @@ mv ancien-nom.txt nouveau-nom.txt ls ``` -```console [Sortie] +```console [Output] compose.yaml compose.yaml.bak config config-backup nouveau-nom.txt ``` @@ -169,7 +169,7 @@ Pour éditer un fichier, `nano` ouvre un éditeur simple : les flèches pour se cat .env ``` -```properties [Sortie] +```properties [Output] PUID=1000 PGID=1000 TZ=Europe/Paris @@ -183,7 +183,7 @@ TZ=Europe/Paris grep -rin "password" /home/utilisateur/docker ``` -```console [Sortie] +```console [Output] /home/utilisateur/docker/immich/.env:6:DB_PASSWORD=changeme /home/utilisateur/docker/vaultwarden/compose.yaml:14: ADMIN_PASSWORD=hunter2 ``` @@ -198,7 +198,7 @@ Chaque ligne indique le fichier, puis le numéro de ligne à l'intérieur, puis nano /etc/ssh/sshd_config ``` -```console [Sortie] +```console [Output] Error writing /etc/ssh/sshd_config: Permission denied ``` @@ -206,7 +206,7 @@ Error writing /etc/ssh/sshd_config: Permission denied sudo nano /etc/ssh/sshd_config ``` -```console [Sortie] +```console [Output] [sudo] password for utilisateur: ``` diff --git a/content/fr/2.general/5.linux/3.handy-tools.md b/content/fr/2.general/5.linux/3.handy-tools.md index 171c9fa..4c6cbd1 100644 --- a/content/fr/2.general/5.linux/3.handy-tools.md +++ b/content/fr/2.general/5.linux/3.handy-tools.md @@ -247,7 +247,7 @@ sudo ufw enable sudo ufw status verbose ``` -```console [Sortie] +```console [Output] Status: active Logging: on (low) Default: deny (incoming), allow (outgoing), disabled (routed) -- 2.54.0 From eff68287f203ffdcf8bb6233593d316a362f7514 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 14:15:37 +0200 Subject: [PATCH 16/20] Fix French spelling and typos across the 8 older pages and other flagged articles (missing accents, typos, broken sentences) --- content/en/2.general/5.linux/1.cli-basics.md | 2 +- content/fr/1.about/1.welcome.md | 2 +- content/fr/2.general/2.networking/2.dns.md | 2 +- content/fr/2.general/2.networking/3.samba.md | 12 ++-- content/fr/2.general/3.storage/2.zfs.md | 8 +-- content/fr/2.general/4.hardware/1.basics.md | 58 +++++++++---------- content/fr/2.general/4.hardware/2.network.md | 56 +++++++++--------- content/fr/2.general/4.hardware/3.prolonas.md | 20 +++---- content/fr/2.general/5.linux/1.cli-basics.md | 10 ++-- content/fr/2.general/5.linux/2.filesystem.md | 8 +-- content/fr/2.general/5.linux/3.handy-tools.md | 2 +- content/fr/3.serveex/2.core/1.installation.md | 2 +- content/fr/3.serveex/2.core/3.wireguard.md | 16 ++--- .../fr/3.serveex/3.security/2.cloudflare.md | 18 +++--- content/fr/3.serveex/9.apps/1.adguard.md | 24 ++++---- 15 files changed, 120 insertions(+), 120 deletions(-) diff --git a/content/en/2.general/5.linux/1.cli-basics.md b/content/en/2.general/5.linux/1.cli-basics.md index eeea6a9..331cfdc 100644 --- a/content/en/2.general/5.linux/1.cli-basics.md +++ b/content/en/2.general/5.linux/1.cli-basics.md @@ -241,7 +241,7 @@ The ones worth keeping at hand, and where their names come from. | `chmod` | change mode | Changes a file's permissions | | `chown` | change owner | Changes who owns a file | | `sudo` | substitute user do | Runs one command as administrator | -| `apt` | advanced package tool | Installs, updates and removes packages | +| `apt` | Advanced Packaging Tool | Installs, updates and removes packages | | `systemctl` | control systemd | Starts, stops and enables services | | `ssh` | secure shell | Opens a session on a remote machine | | `scp` | secure copy | Copies files over SSH | diff --git a/content/fr/1.about/1.welcome.md b/content/fr/1.about/1.welcome.md index b3a3178..90b9838 100644 --- a/content/fr/1.about/1.welcome.md +++ b/content/fr/1.about/1.welcome.md @@ -16,7 +16,7 @@ __Docu[·]{style="color: #1ad6ff"}djeex__ est le site regroupant la documentatio ## À propos de la documentation -La documentation fournie ici est distribuée à titre expérimentale, dans un esprit de partage d'expérience. Elle n'est en aucun cas faite pour construire une architecture de production ou pour de l'industrialisation. Il est possible qu'elle contienne des erreurs et/ou des approximations. +La documentation fournie ici est distribuée à titre expérimental, dans un esprit de partage d'expérience. Elle n'est en aucun cas faite pour construire une architecture de production ou pour de l'industrialisation. Il est possible qu'elle contienne des erreurs et/ou des approximations. Evidemment, l'usage de cette documentation doit strictement se limiter au cadre légal. diff --git a/content/fr/2.general/2.networking/2.dns.md b/content/fr/2.general/2.networking/2.dns.md index 19fcb25..b019872 100644 --- a/content/fr/2.general/2.networking/2.dns.md +++ b/content/fr/2.general/2.networking/2.dns.md @@ -56,4 +56,4 @@ Et si vous ajoutez un sous-domaine qui doit pointer vers votre serveur, vous pou __Pourquoi ne pas utiliser un enregistrement `A` pour le sous-domaine ?__ Si votre sous domaine pointe sur le meme serveur que `mondomaine.fr`, il vaut mieux utiliser un enregistrement `CNAME` car en cas de changement d'IP du serveur, il n'y aura aucune autre manipulation à faire. :: -La plupart des registrar proposent des interfaces plus lisbles pour modifier ces informations. Renseignez-vous auprès de la documentation de votre registrar. +La plupart des registrar proposent des interfaces plus lisibles pour modifier ces informations. Renseignez-vous auprès de la documentation de votre registrar. diff --git a/content/fr/2.general/2.networking/3.samba.md b/content/fr/2.general/2.networking/3.samba.md index f509b48..92109dc 100644 --- a/content/fr/2.general/2.networking/3.samba.md +++ b/content/fr/2.general/2.networking/3.samba.md @@ -15,7 +15,7 @@ De nombreux tutorials existent pour configurer Samba sous windows ou sur un NAS ## Créer et configurer un dossier réseau partagé ::note -Ici, nous allons partager le dossier `/video` d'une machine distant que nous appelerons `machine-distante`. Nous accéderons à ce dossier par la machine nommée `machine-locale`. L'utilisateur de connexion au disque réseau sera `sambauser`. +Ici, nous allons partager le dossier `/video` d'une machine distante que nous appellerons `machine-distante`. Nous accéderons à ce dossier par la machine nommée `machine-locale`. L'utilisateur de connexion au disque réseau sera `sambauser`. :: ::steps{level="3"} @@ -75,7 +75,7 @@ Comme nous avons configuré un partage sécurisé, nous allons devoir créer un sudo groupadd smbshare ``` -Nous allons maintenant permettre au groupe d'avoir le controle sur le dossier `/video`. +Nous allons maintenant permettre au groupe d'avoir le contrôle sur le dossier `/video`. ```bash [Terminal] sudo chgrp -R smbshare /video @@ -88,7 +88,7 @@ sudo chmod 2775 /video ``` ### Créer l'utilisateur -A présent nous allons ajouter un utilisateur nologin c'est à dire que cet utilisateur ne pourra pas se connecter sur le serveur pour faire des opérations, mais pourra tout de meme se connecter au service samba. +A présent nous allons ajouter un utilisateur nologin c'est-à-dire que cet utilisateur ne pourra pas se connecter sur le serveur pour faire des opérations, mais pourra tout de même se connecter au service samba. ```bash [Terminal] sudo useradd -M -s /sbin/nologin sambauser @@ -126,7 +126,7 @@ sudo apt install cifs-utils ### Créer le dossier de destination -Nous allons créer un dossier sur notre serveur sur lequel sera monté le dossier partagé de notre `machine-distante`. C'est à dire que dans ce dossier nous retrouverons le contenu du dossier partagé de notre `machine-distante`. Ici nous appellerons ce dossier `/mnt/video`. +Nous allons créer un dossier sur notre serveur sur lequel sera monté le dossier partagé de notre `machine-distante`. C'est-à-dire que dans ce dossier nous retrouverons le contenu du dossier partagé de notre `machine-distante`. Ici nous appellerons ce dossier `/mnt/video`. ```bash [Terminal] sudo mkdir /mnt/video @@ -155,7 +155,7 @@ password=motdepasse Enregistrez avec :kbd{value="Ctrl+O"} puis :kbd{value="Entrée"}, puis quittez avec :kbd{value="Ctrl+X"}. -Nous allons modifier les permissions du dossier afin que seul le propriétaire puis lire et écrire dans ce fichier. +Nous allons modifier les permissions du dossier afin que seul le propriétaire puisse lire et écrire dans ce fichier. ```bash [Terminal] sudo chmod 600 /smb/.credentials @@ -182,7 +182,7 @@ Vérifiez que cela a fonctionné en tapant : sudo mount -t cifs ``` -Vous verrez différentes informations qui confirmerons le succès du montage. +Vous verrez différentes informations qui confirmeront le succès du montage. Et voilà, à présent vous accédez au dossier /video de `votre machine-distante`, depuis votre `machine-locale` ! diff --git a/content/fr/2.general/3.storage/2.zfs.md b/content/fr/2.general/3.storage/2.zfs.md index 15d1fcb..1766d84 100644 --- a/content/fr/2.general/3.storage/2.zfs.md +++ b/content/fr/2.general/3.storage/2.zfs.md @@ -7,7 +7,7 @@ description: Introduction à ZFS, système de fichiers et gestionnaire de volume :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -ZFS est populaire dans le monde des serveurs, des NAS (comme FreeNAS / TrueNAS), de la virtualisation, et même chez les particuliers qui veulent un stockage résilient. C'est est un _système de fichier_ (à l'instar de NTFS pour windows, EXT4, FAT32 etc...) mais également un _gestionnaire de volume_ (comme LVM par exemple). +ZFS est populaire dans le monde des serveurs, des NAS (comme FreeNAS / TrueNAS), de la virtualisation, et même chez les particuliers qui veulent un stockage résilient. C'est un _système de fichier_ (à l'instar de NTFS pour windows, EXT4, FAT32 etc...) mais également un _gestionnaire de volume_ (comme LVM par exemple). Pour le dire simplement : @@ -17,9 +17,9 @@ Pour le dire simplement : ZFS dépasse largement les limites des autres systèmes de fichiers, que ce soit en termes de performance ou de fonctionnalités. Ce qui nous intéresse le plus : -- ses fonctionnalités de __gestion des instantanés__ (snaphsot), permettant de rapidement revenir en arrière en cas de problème +- ses fonctionnalités de __gestion des instantanés__ (snapshot), permettant de rapidement revenir en arrière en cas de problème - sa gestion des grappes de disques et [__ses équivalent au RAID__](/general/storage/raid) (Z-Mirror, RAIDZ1, RAIDZ2, RAIDZ3) -- sa __reconstruction automatique des données corrumpues__ (via le scrubbing) +- sa __reconstruction automatique des données corrompues__ (via le scrubbing) - ses performance avec son cache RAM (ZFS ARC) - ses notifications en cas d'erreur @@ -36,7 +36,7 @@ Il existe plusieurs types de dataset : - __file system__ : un système de fichier, ZFS par défaut, monté comme un volume sans quota de stockage. - __zvol__ : un "disque virtuel" avec un quota d'espace, que vous pouvez formater/partitionner comme vous le souhaitez. Il sera utilisable comme un disque physique. -- __snapshot__ : un état figé d’un autre dataset à un instant donné. Ils peuvent etre créés manuellement ou via des outils de sauvegarde. Ils peuvent etre montés pour parcourir les données dans leur état au moment du snapshot. +- __snapshot__ : un état figé d’un autre dataset à un instant donné. Ils peuvent être créés manuellement ou via des outils de sauvegarde. Ils peuvent être montés pour parcourir les données dans leur état au moment du snapshot. ## Pourquoi ZFS vs les autres ? ### Intégrité des données diff --git a/content/fr/2.general/4.hardware/1.basics.md b/content/fr/2.general/4.hardware/1.basics.md index 0a362c4..bc7bb81 100644 --- a/content/fr/2.general/4.hardware/1.basics.md +++ b/content/fr/2.general/4.hardware/1.basics.md @@ -8,17 +8,17 @@ description: Les fondamentaux du matériel serveur. CPU, RAM, stockage et facteu ![hardware](/img/global/hardware.svg) -Un __serveur__ n'est rien d'autre qu'un ordinateur dédié à des taches particulières, ayant vocation à rester accessible en permanence. En soi, sa structure ne diffère pas d'un ordinateur classique, si ce n'est que selon l'usage cible, on fera évoluer certains composants dans un sens ou dans un autre. Dans cet article, vous trouverez un aide mémoire pour comprendre quels sont les composants essentiels d'un serveur et comprendre leur fonction selon vos usages. +Un __serveur__ n'est rien d'autre qu'un ordinateur dédié à des tâches particulières, ayant vocation à rester accessible en permanence. En soi, sa structure ne diffère pas d'un ordinateur classique, si ce n'est que selon l'usage cible, on fera évoluer certains composants dans un sens ou dans un autre. Dans cet article, vous trouverez un aide mémoire pour comprendre quels sont les composants essentiels d'un serveur et comprendre leur fonction selon vos usages. ## La carte mère -La __carte mère__ est le socle de votre machine. C'est le composant qui relie tous les autres composants. Elle sert à les faire communiquer et à interagir avec vos périphériques (clavier, souris, etc...). Il faut donc la choisir en fonction de vos besoins en terme d'entrées/sorties (I/O) comme le nombre de ports USB, de ports réseau, leur vitesse, etc... Mais il faut également veiller à sa compatibilité avec les autres composants que vous allez brancher dessus. +La __carte mère__ est le socle de votre machine. C'est le composant qui relie tous les autres composants. Elle sert à les faire communiquer et à interagir avec vos périphériques (clavier, souris, etc.). Il faut donc la choisir en fonction de vos besoins en terme d'entrées/sorties (I/O) comme le nombre de ports USB, de ports réseau, leur vitesse, etc. Mais il faut également veiller à sa compatibilité avec les autres composants que vous allez brancher dessus. Les composants importants à brancher dessus sont : - le CPU - la RAM - le stockage (HDD et/ou SSD) -- l'eventuel GPU dédié +- l'éventuel GPU dédié Il existe plusieurs formats de carte mère grand public : @@ -32,21 +32,21 @@ Bien sûr, selon la taille, le nombre de ports et de fonctionnalité diffère. D ## Le CPU
Image -

Le CPU (Central processor Unit) est la supercalculette de l’ordinateur. Il traite la plupart des tâches logicielles. Aujourd’hui les processeurs comportent plusieurs cœurs, parfois eux même divisé en deux de façon logicielle, afin de mieux répartir la charge de travail et optimiser son fonctionnement. Il nécessite d'etre refroidit avec un dissipateur actif (avec ventilateur) ou passif (sans ventilateur) selon la chaleur qu'iil dégage, et donc selon la puissance en Watt qu'il requiert. Dans le cadre d'un serveur, on veillera donc à le choisir selon les usages que l'on aura.

+

Le CPU (Central Processing Unit) est la supercalculette de l’ordinateur. Il traite la plupart des tâches logicielles. Aujourd’hui les processeurs comportent plusieurs cœurs, parfois eux-mêmes divisés en deux de façon logicielle, afin de mieux répartir la charge de travail et optimiser son fonctionnement. Il nécessite d'être refroidi avec un dissipateur actif (avec ventilateur) ou passif (sans ventilateur) selon la chaleur qu'il dégage, et donc selon la puissance en Watt qu'il requiert. Dans le cadre d'un serveur, on veillera donc à le choisir selon les usages que l'on aura.

::warning -__Attention :__ N'oubliez pas que pour installer un dissipateur tiers, vous devez vous assurer qu'il soit compatible avec le socket de votre processeur, c'est à dire le socle sur lequel il est installé sur la carte mère, et que vous devez également appliquer de la pate thermique sur le CPU avant d'installer le dissipateur. +__Attention :__ N'oubliez pas que pour installer un dissipateur tiers, vous devez vous assurer qu'il soit compatible avec le socket de votre processeur, c'est-à-dire le socle sur lequel il est installé sur la carte mère, et que vous devez également appliquer de la pâte thermique sur le CPU avant d'installer le dissipateur. :: Il faut les juger selon : -- Leur nombre de coeurs (plus ils en ont, plus il peuvent paralléliser les tâches) -- La fréquence de ces coeurs en Giga Hertz _Ghz_ +- Leur nombre de cœurs (plus ils en ont, plus il peuvent paralléliser les tâches) +- La fréquence de ces cœurs en Giga Hertz _GHz_ - Leur consommation en Watt _W_ -Dans le cadre d'un homelab/NAS sans calcul intensif, aujourd'hui on se dirigera facilement vers les Intel N100/150 (4 coeurs) et N305/N355 (8 coeurs) qui sont des processeurs performants à très faible consommation (rappelez vous que ces machines sont censées tourner H24). +Dans le cadre d'un homelab/NAS sans calcul intensif, aujourd'hui on se dirigera facilement vers les Intel N100/150 (4 cœurs) et N305/N355 (8 cœurs) qui sont des processeurs performants à très faible consommation (rappelez vous que ces machines sont censées tourner H24). ## La RAM @@ -54,15 +54,15 @@ Dans le cadre d'un homelab/NAS sans calcul intensif, aujourd'hui on se dirigera Image

-La __RAM__ (Random Access Memory), est une zone de stockage éphémère ultra rapide utilisée par le CPU (et l'iGPU le cas échéant) pour stocker des informations et calculs le temps de les éxecuter. Elle se vide régulièrement selon les sollicitation et se vide également à chaque extinction de la machine. Plus elle est performante, plus les calculs du processeur sont efficaces. +La __RAM__ (Random Access Memory), est une zone de stockage éphémère ultra rapide utilisée par le CPU (et l'iGPU le cas échéant) pour stocker des informations et calculs le temps de les exécuter. Elle se vide régulièrement selon les sollicitations et se vide également à chaque extinction de la machine. Plus elle est performante, plus les calculs du processeur sont efficaces. -Elle prend généralement la forme de barettes, à brancher sur la carte mère. Il en existe plusieurs format selon le type de carte mère, et de plusieurs générations (DDR5 de nos jours). +Elle prend généralement la forme de barrettes, à brancher sur la carte mère. Il en existe plusieurs format selon le type de carte mère, et de plusieurs générations (DDR5 de nos jours). ## Le GPU -Le __GPU__ (Graphical Processor Unit) est un processeur dédié aux calculs graphiques, vidéo, et parfois d'intelligence artificielle. Dans le cadre d'un serveur, il aura son utilité pour tout ce qui touche au media center (par exemple [Jellyfin](/serveex/media/jellyfin)), mais aussi en terme d'accélération matérielle pour les calculs d'IA comme la reconnaissance faciale ou la recherche sur des photos (comme via [Immich](/serveex/cloud/immich) par exemple). +Le __GPU__ (Graphics Processing Unit) est un processeur dédié aux calculs graphiques, vidéo, et parfois d'intelligence artificielle. Dans le cadre d'un serveur, il aura son utilité pour tout ce qui touche au media center (par exemple [Jellyfin](/serveex/media/jellyfin)), mais aussi en terme d'accélération matérielle pour les calculs d'IA comme la reconnaissance faciale ou la recherche sur des photos (comme via [Immich](/serveex/cloud/immich) par exemple). -Selon la puissance requise, on choisira un GPU dédié avec sa propre VRAM (une carte graphique à brancher sur un port PCIe de la carte mère), ou un iGPU, c'est à dire un GPU compris dans le CPU (comme les N100/N150 et N305/N355), qui utilisera la RAM globale de la machine +Selon la puissance requise, on choisira un GPU dédié avec sa propre VRAM (une carte graphique à brancher sur un port PCIe de la carte mère), ou un iGPU, c'est-à-dire un GPU compris dans le CPU (comme les N100/N150 et N305/N355), qui utilisera la RAM globale de la machine ## Le ou les HDD @@ -70,11 +70,11 @@ Selon la puissance requise, on choisira un GPU dédié avec sa propre VRAM (une Image

-Un __HDD__ (Hard Disk Drive) ou disque dur, est un composant servant à stocker des données. Autrefois, c'etait le stockage standard des machines informatiques. Ils sont constitués d'un ou plusieurs disques superposés en plateau, et de têtes de lecture, presque comme une platine vinyle. +Un __HDD__ (Hard Disk Drive) ou disque dur, est un composant servant à stocker des données. Autrefois, c'était le stockage standard des machines informatiques. Ils sont constitués d'un ou plusieurs disques superposés en plateau, et de têtes de lecture, presque comme une platine vinyle. Aujourd'hui, les HDD peuvent stocker des quantités extraordinaires de données (jusqu'à 30 To, soit 30 000 gigaoctets, pour les modèles grand public), mais ils restent limités en vitesse de lecture et d'écriture par leur nature mécanique. Ils sont également volumineux et très lourds. -De manière générale, on les privilégiera pour stocker des données qui ne servent pas à des calculs et ne nécessitent pas d'ecriture rapide, comme les media (videos, photos...) ou les cloud drive, stockage d'archives, etc. Ils sont performants dans ces scenario et surtout coutent beaucoup moins cher que des SSD à espace de stockage égal. +De manière générale, on les privilégiera pour stocker des données qui ne servent pas à des calculs et ne nécessitent pas d'écriture rapide, comme les media (vidéos, photos...) ou les cloud drive, stockage d'archives, etc. Ils sont performants dans ces scénarios et surtout coûtent beaucoup moins cher que des SSD à espace de stockage égal. ::tip{icon="" to="/general/storage/raid"} ✨ __Astuce :__ combinez plusieurs HDD en **RAID** pour améliorer les performances et la redondance. @@ -92,24 +92,24 @@ Un __SSD__ (Solid State Drive) est une petite carte sur laquelle sont soudées d Contrairement aux HDD, ils ne disposent pas de parties mécaniques, sont très miniaturisés et surtout extrêmement rapides, de l'ordre de plusieurs gigaoctets par seconde pour les plus performants. -On les trouve dans plusieurs formats, aujourd'hui on priviligiera les versions M.2 NVMe, car ce sont les plus petits et plus rapides, et sont devenu un standard sur les cartes mères. +On les trouve dans plusieurs formats, aujourd'hui on privilégiera les versions M.2 NVMe, car ce sont les plus petits et plus rapides, et sont devenues un standard sur les cartes mères. -Ils sont en revanche beaucoup plus chers que les disque durs à capacité de stockage égale. Généralement, on y stockera au moins le système d'exploitation de la machine (Operating System ou OS) pour garantir une certaine rapidité d'execution. Dans le cadre d'un serveur, on y stockera aussi si possible les conteneurs type [docker](/serveex/core/docker) et les bases de données. De manière générale, toute données dont un a besoin régulièrement et rapidement pour des calculs (site web, applications, etc...). +Ils sont en revanche beaucoup plus chers que les disque durs à capacité de stockage égale. Généralement, on y stockera au moins le système d'exploitation de la machine (Operating System ou OS) pour garantir une certaine rapidité d'exécution. Dans le cadre d'un serveur, on y stockera aussi si possible les conteneurs type [docker](/serveex/core/docker) et les bases de données. De manière générale, toute données dont un a besoin régulièrement et rapidement pour des calculs (site web, applications, etc.). ## La carte réseau -Une __carte réseau__ sert à faire communiquer votre machine avec votre réseau (dont internet). Elle est composée d'une puce de controle et d'un ou plusieurs port réseau. Ces ports peuvent dits _ports ethernet_ peuvent être dans plusieurs formats physique et dans plusieurs normes de débit : +Une __carte réseau__ sert à faire communiquer votre machine avec votre réseau (dont internet). Elle est composée d'une puce de contrôle et d'un ou plusieurs port réseau. Ces ports, aussi appelés _ports ethernet_, existent dans plusieurs formats physiques et plusieurs normes de débit : - RJ45 Gigabit ethernet 10/100/1000 : le format standard de prise RJ45 permettant de dialoguer à des débit allant de 10Mbps (soit 1,25Mo/s) à 1000Mbps (soit 125Mo/s) -- RJ45 2.5G : Même prise, pouvant dialoguer jusqu'à 2,5Gpbs soit 2 500Mbps (donc 312,5Mo/s) -- RJ45 5G : Même prise, pouvant dialoguer jusqu'à 5Gpbs (donc 625Mo/s) -- RJ45 10G Base T : Même prise pouvant dialoguer jusqu'à 10Gbs (soit 1,25Go/s) -- SFP 1G : Prise SFP, généralement utilisée pour la fibre optique, pouvant dialoguer jusqu'à 1Gpbs -- SFP+ 10G : Prise SFP amélioriée, aussi utilisée pour la fibre optique, pouvant dialoguer jusqu'à 10Gbps. +- RJ45 2.5G : Même prise, pouvant dialoguer jusqu'à 2,5Gbps soit 2 500Mbps (donc 312,5Mo/s) +- RJ45 5G : Même prise, pouvant dialoguer jusqu'à 5Gbps (donc 625Mo/s) +- RJ45 10G Base T : Même prise pouvant dialoguer jusqu'à 10Gbps (soit 1,25Go/s) +- SFP 1G : Prise SFP, généralement utilisée pour la fibre optique, pouvant dialoguer jusqu'à 1Gbps +- SFP+ 10G : Prise SFP améliorée, aussi utilisée pour la fibre optique, pouvant dialoguer jusqu'à 10Gbps. ::warning -__Attention :__ Pensez bien à dimensionner vos appareils réseaux (routeurs, switch, cables...) en fonction du débit que vous souhaitez entre vos appareils. D'autre part, il existe plusieurs normes de cables RJ45 selon la vitesse permise. On privilegiera dans la plupart des cas des cables RJ45 CAT5E, et au delà de 10Gbps, on privilégiera du CAT6A, bien que le CAT5E soit utilisable à ces vitesses à courte distance. Quant à la fibre, c'est tout un sujet (simplex, duplex, transceiver...). +__Attention :__ Pensez bien à dimensionner vos appareils réseaux (routeurs, switch, câbles...) en fonction du débit que vous souhaitez entre vos appareils. D'autre part, il existe plusieurs normes de câbles RJ45 selon la vitesse permise. On privilégiera dans la plupart des cas des câbles RJ45 CAT5E, et au-delà de 10Gbps, on privilégiera du CAT6A, bien que le CAT5E soit utilisable à ces vitesses à courte distance. Quant à la fibre, c'est tout un sujet (simplex, duplex, transceiver...). :: La carte réseau est généralement directement intégrée à la carte mère, mais vous pouvez aussi utiliser des cartes réseau dédiées, par exemple en USB ou via un port d'extension PCIe. @@ -137,18 +137,18 @@ Une alimentation se caractérise par plusieurs éléments clés : - sa modularité (câbles fixes ou détachables), - son rendement (en pourcentage). Par exemple, une alimentation de 500W avec 80% de rendement tirera en réalité 625W au mur pour fournir 500W à la machine. -Un autre facteur important est le format. Il en existe plusieurs standard, comme ATX L pour les plus grandes jusqu'à SFX pour les plus petites. Il en existe aussi des spécifiques aux serveurs rackables, par définition assez plats. +Un autre facteur important est le format. Il en existe plusieurs standards, comme ATX L pour les plus grandes jusqu'à SFX pour les plus petites. Il en existe aussi des spécifiques aux serveurs rackables, par définition assez plats. -Pour choisir votre alimentation, la convention est d'estimer la puissance electrique demandée par votre machine à usage et de multiplier par deux cette puissance. En effet, le rendement des alimentations se situe environ à 50% de sa charge totale. +Pour choisir votre alimentation, la convention est d'estimer la puissance électrique demandée par votre machine à usage et de multiplier par deux cette puissance. En effet, le rendement des alimentations se situe environ à 50% de sa charge totale. -## Le boitier +## Le boîtier
Image -

Le boitier est également un composant essentiel pour votre machine. Il joue un rôle clé dans le refroidissement, avec ses ventilateurs et sa conception des flux d'air, et il détermine la compatibilité de format de votre carte mère, de votre alimentation et de l'éventuel GPU dédié que vous installerez. +

Le boîtier est également un composant essentiel pour votre machine. Il joue un rôle clé dans le refroidissement, avec ses ventilateurs et sa conception des flux d'air, et il détermine la compatibilité de format de votre carte mère, de votre alimentation et de l'éventuel GPU dédié que vous installerez.

-Par ailleurs, le boitier détermine combien de HDD vous pouvez installer et quels formats ils acceptent. Certains boitiers sont rackables, c'est-à-dire qu'ils peuvent être installés dans des racks (baies serveurs). +Par ailleurs, le boîtier détermine combien de HDD vous pouvez installer et quels formats ils acceptent. Certains boîtiers sont rackables, c'est-à-dire qu'ils peuvent être installés dans des racks (baies serveurs). -Choisissez votre boitier avec soin en fonction de vos besoins précis et du matériel que vous comptez utiliser. +Choisissez votre boîtier avec soin en fonction de vos besoins précis et du matériel que vous comptez utiliser. diff --git a/content/fr/2.general/4.hardware/2.network.md b/content/fr/2.general/4.hardware/2.network.md index 0bc04f1..3630047 100644 --- a/content/fr/2.general/4.hardware/2.network.md +++ b/content/fr/2.general/4.hardware/2.network.md @@ -8,20 +8,20 @@ description: Aperçu du matériel réseau pour homelab. Switches, cartes réseau ![hardware](/img/global/hardware-networking.svg) -Un réseau informatique est indissociable du matériel nécessaire à le mettre en place. Le matériel va conditionner les dimension du réseau, les vitesses de communication et les performances du réseau. Dans cet article, nous nous limiterons au réseau les plus simples, composant généralement ceux que l'on peut retrouver chez soi. +Un réseau informatique est indissociable du matériel nécessaire à sa mise en place. Le matériel va conditionner les dimensions du réseau, les vitesses de communication et les performances du réseau. Dans cet article, nous nous limiterons aux réseaux les plus simples, ceux que l'on peut généralement retrouver chez soi. ## Le routeur -Le __routeur__ est le point central de votre réseau. C'est lui qui dirige les __paquets__, c'est à dire les blocs d'informations qui transitent sur votre réseau, de l'émetteur vers le bon destinataire. Il permet à la fois de conditionner le routage de l'information au sein de votre réseau mais aussi vers ou depuis l'exterieur. Globalement, il fait communiquer les appareils entre eux et avec internet. +Le __routeur__ est le point central de votre réseau. C'est lui qui dirige les __paquets__, c'est-à-dire les blocs d'informations qui transitent sur votre réseau, de l'émetteur vers le bon destinataire. Il permet à la fois de conditionner le routage de l'information au sein de votre réseau mais aussi vers ou depuis l'extérieur. Globalement, il fait communiquer les appareils entre eux et avec internet. Vous avez tous un routeur chez vous, c'est la __box__ de votre _FAI_ (Fournisseur d'Accès à Internet). Plus généralement, un routeur est composé : - d'un port WAN (Wide Area Network) recevant les informations depuis l'internet (ou un réseau de hiérarchie supérieure). Par exemple un port recevant la fibre optique de votre opérateur, ou un port SFP+/RJ45 pour un routeur tiers. -- d'un switch, c'est à dire d'un hub composé de plusieurs ports __LAN__ (Local Area Network) permettant de connecter plusieurs lignes et appareils à votre routeur. Ils peuvent etre RJ45 ou SFP/SFP+. +- d'un switch, c'est-à-dire d'un hub composé de plusieurs ports __LAN__ (Local Area Network) permettant de connecter plusieurs lignes et appareils à votre routeur. Ils peuvent être RJ45 ou SFP/SFP+. - parfois d'un emetteur/recepteur WiFi -Le routeur peut posséder des capacité de _firewall_, c'est à dire de limiter le traffic d'appareils en particulier, et de _[NAT (Network Adress Translation)](/general/networking/nat)_, c'est à dire de redirection de port. Il possède aussi généralement un _[DHCP (Dynamic Host Configuration Protocol)](/general/networking/nat#le-dhcp)_, servant à attribuer dynamiquement des _adresses IP_ à votre matériel branché au réseau. +Le routeur peut posséder des capacités de _firewall_, c'est-à-dire de limiter le trafic d'appareils en particulier, et de _[NAT (Network Address Translation)](/general/networking/nat)_, c'est-à-dire de redirection de port. Il possède aussi généralement un _[DHCP (Dynamic Host Configuration Protocol)](/general/networking/nat#le-dhcp)_, servant à attribuer dynamiquement des _adresses IP_ à votre matériel branché au réseau. Le routeur conditionne directement la vitesse de communication entre vos appareils. En effet, le port WAN conditionne le débit qu'il peut recevoir de la part de votre FAI. Si vous avez un abonnement de 5 Gb/s, il vous faudra un port WAN d'au moins 5 Gb/s. Mais il conditionne également la vitesse de communication entre vos équipements. Si vous avez des appareils qui communiquent à 5 Gb/s, il faudra que la partie _switch_ du routeur disposent de ports 5 Gb/s. Enfin, si vous avez du matériel WiFi 7 et que vous souhaitez profiter de ces débits, il faudra également que votre routeur le supporte. Et dans le cas d'une borne Wifi tierce, n'oubliez pas que son port réseau doit disposer d'un débit au moins égale au WiFi qu'il diffuse, et le routeur également. @@ -29,16 +29,16 @@ Débit internet, nombre d'équipements à brancher, débit WiFi, débit réseau, ::tip{icon=""} ✨ __Astuce :__ -Vous pouvez utiliser sans difficulté un routeur tiers pour votre réseau qui remplacera la gestion de votre box internet si celle-ci surpporte le mode _Bridge_. En France seul l'opérateur Free le permet. C'est également possible avec les opérateurs ne disposant pas de ce mode, mais avec de grandes difficultés et sans toutes les fonctionnalités qu'un routeur tiers pourrait vous apporter. +Vous pouvez utiliser sans difficulté un routeur tiers pour votre réseau qui remplacera la gestion de votre box internet si celle-ci supporte le mode _Bridge_. En France seul l'opérateur Free le permet. C'est également possible avec les opérateurs ne disposant pas de ce mode, mais avec de grandes difficultés et sans toutes les fonctionnalités qu'un routeur tiers pourrait vous apporter. :: ## Le Switch -Le __switch__ ou commutateur, est un appareil qui permet de brancher plusieurs appareils au réseau. C'est littéralement un hub, qui se connecte directement au routeur ou à un autre switch, jusqu'au routeur. Il permet d'éviter de saturer toutes les prises switch du routeur, ou de délocaliser le matériel dans une autre pièce, sans tirer un cable par appareil vers le routeur. Un autre cas d'usage est de pouvoir séparer plusieurs réseaux gérés par un meme routeur. +Le __switch__ ou commutateur, est un appareil qui permet de brancher plusieurs appareils au réseau. C'est littéralement un hub, qui se connecte directement au routeur ou à un autre switch, jusqu'au routeur. Il permet d'éviter de saturer toutes les prises switch du routeur, ou de délocaliser le matériel dans une autre pièce, sans tirer un câble par appareil vers le routeur. Un autre cas d'usage est de pouvoir séparer plusieurs réseaux gérés par un même routeur. Il en existe globalement de deux types : -- Les switch non managés, les plus courants. Ils sont plug-n-play, c'est à dire que vous les branchez et tout est réglé tout seul. +- Les switch non managés, les plus courants. Ils sont plug-n-play, c'est-à-dire que vous les branchez et tout est réglé tout seul. - Les switchs managés. Ils disposent d'une interface de configuration (en ligne de commande ou via une interface web), servant à affiner les règles de routages asservies au routeur. C'est très efficace pour séparer des réseaux virtuels entre vos appareils, mais généralement nécessite beaucoup de temps de configuration et sont moins pratiques à utiliser qu'un simple switch non managé. ::warning @@ -46,22 +46,22 @@ Il en existe globalement de deux types : __Attention :__ Veillez à bien utiliser un switch avec des ports disposant des débits cohérents avec le matériel de votre réseau :: -## Les cables +## Les câbles -Les cables sont des composants essentiels de votre réseau. Selon leur type et catégorie, ils limiteront le débit entre vos appareils et nécessitent donc d'etre dimensionnés de manière cohérente avec votre réseau. Ils doivent aussi être compatibles avec les ports de vos appareils. +Les câbles sont des composants essentiels de votre réseau. Selon leur type et catégorie, ils limiteront le débit entre vos appareils et nécessitent donc d'être dimensionnés de manière cohérente avec votre réseau. Ils doivent aussi être compatibles avec les ports de vos appareils. -Voici un rappel des normes de cables et de ports les plus courantes : +Voici un rappel des normes de câbles et de ports les plus courantes : - **RJ45 Gigabit Ethernet 10/100/1000** : le format standard de prise RJ45 permettant de dialoguer à des débit allant de 10Mbps (soit 1,25Mo/s) à 1000Mbps (soit 125Mo/s) -- **RJ45 2.5G** : Même prise, pouvant dialoguer jusqu'à 2,5Gpbs soit 2 500Mbps (donc 312,5Mo/s) -- **RJ45 5G** : Même prise, pouvant dialoguer jusqu'à 5Gpbs (donc 625Mo/s) +- **RJ45 2.5G** : Même prise, pouvant dialoguer jusqu'à 2,5Gbps soit 2 500Mbps (donc 312,5Mo/s) +- **RJ45 5G** : Même prise, pouvant dialoguer jusqu'à 5Gbps (donc 625Mo/s) - **RJ45 10GBase-T** : Même prise pouvant dialoguer jusqu'à 10Gb/s (soit 1,25Go/s) -- **SFP 1G** : Prise SFP, généralement utilisée pour la fibre optique, pouvant dialoguer jusqu'à 1Gpbs -- **SFP+ 10G** : Prise SFP amélioriée, aussi utilisée pour la fibre optique, pouvant dialoguer jusqu'à 10Gb/s. +- **SFP 1G** : Prise SFP, généralement utilisée pour la fibre optique, pouvant dialoguer jusqu'à 1Gbps +- **SFP+ 10G** : Prise SFP améliorée, aussi utilisée pour la fibre optique, pouvant dialoguer jusqu'à 10Gb/s. -### Les cables Ethernet +### Les câbles Ethernet -Ces cables en cuivre disposent généralement d'une prise dite `RJ45`. C'est la prise la plus standard du matériel réseau, que vous retrouvez sur vos routeurs et vos switch. +Ces câbles en cuivre disposent généralement d'une prise dite `RJ45`. C'est la prise la plus standard du matériel réseau, que vous retrouvez sur vos routeurs et vos switch. Ils sont définis en plusieurs catégorie, définissant le débit maximal selon la distance : @@ -76,40 +76,40 @@ Ils sont définis en plusieurs catégorie, définissant le débit maximal selon | 1 Gb/s | CAT 5e | 100 m | | 100 Mbs | CAT 5 | 100 m | -Certains de ces cables sont plats, ronds, blindés (à relier à la terre), etc. Choisissez en fonction de votre installation. ce qu'il faut comprendre, c'est que pour relier un appareil qui dispose d'une prise RJ45 ethernet 2.5 Gb/s sur un routeur 2.5G b/s, il faut au moins un cable `CAT 5e`. +Certains de ces câbles sont plats, ronds, blindés (à relier à la terre), etc. Choisissez en fonction de votre installation. ce qu'il faut comprendre, c'est que pour relier un appareil qui dispose d'une prise RJ45 ethernet 2.5 Gb/s sur un routeur 2.5G b/s, il faut au moins un câble `CAT 5e`. -En revanche, si votre appareil est limité à 100 Mb/s, vous n'avez besoin que d'un cable `CAT 5`. +En revanche, si votre appareil est limité à 100 Mb/s, vous n'avez besoin que d'un câble `CAT 5`. -Aujourd'hui, dans les nouvelles construction, la norme est d'installer des cables `CAT 6A` dans les murs. Ainsi, les prises murales sont prêtes à accepter du 10 Gb/s sur 100 m +Aujourd'hui, dans les nouvelles constructions, la norme est d'installer des câbles `CAT 6A` dans les murs. Ainsi, les prises murales sont prêtes à accepter du 10 Gb/s sur 100 m -### Les cables optiques +### Les câbles optiques -Très fins mais très fragile, on commence à les voir de plus en plus dans les installations chez soi. A commencer par le cable opérateur qui relie votre prise fibre à votre box/routeur. Ils ont plusieurs avantages : +Très fins mais très fragiles, on commence à les voir de plus en plus dans les installations chez soi. A commencer par le câble opérateur qui relie votre prise fibre à votre box/routeur. Ils ont plusieurs avantages : - Extrêmement compacts - Consommation électrique nulle (contrairement au cuivre, qui perd de l'énergie en chaleur) - Aucun rayonnement électromagnétique (pas besoin de blindage, pas de perturbation du signal) - Débits très élevés sur de longues distances -Pour du réseau local, il faut comprendre qu'il existe plusieurs types de cables fibres, conditionnant le débit selon la distance, et conditionnant le type de `transceiver` à utiliser. En effet, les cables fibres se branchent sur les ports SFP+ de vos appareils, via un petit objet qui traduit le signal lumineux en information électrique, et qui, dans le sens inverse, traduit les informations électrique en signal lumineux. +Pour du réseau local, il faut comprendre qu'il existe plusieurs types de câbles fibres, conditionnant le débit selon la distance, et conditionnant le type de `transceiver` à utiliser. En effet, les câbles fibres se branchent sur les ports SFP+ de vos appareils, via un petit objet qui traduit le signal lumineux en information électrique, et qui, dans le sens inverse, traduit les informations électriques en signal lumineux. -Globalement, pour du réseau local, on évitera de choisir autre chose qu'un cable multimode OM3 avec prise LC, avec un transceiver LC SFP+ 10G. Cela permet de relier des appareils en 10 Gb/s et est compatible avec la plupart des appareils disposant d'un port SFP+. +Globalement, pour du réseau local, on évitera de choisir autre chose qu'un câble multimode OM3 avec prise LC, avec un transceiver LC SFP+ 10G. Cela permet de relier des appareils en 10 Gb/s et est compatible avec la plupart des appareils disposant d'un port SFP+. ::warning -__Attention :__ Veillez à bien utiliser des `transceiver` compatibles avec vos materiels (routeur, switch ou appareil). Il n'existe pas encore de standard absolu, les constructeurs précisent généralement les marques compatibles. +__Attention :__ Veillez à bien utiliser des `transceiver` compatibles avec vos matériels (routeur, switch ou appareil). Il n'existe pas encore de standard absolu, les constructeurs précisent généralement les marques compatibles. :: -### Les cables DAC +### Les câbles DAC -Ce sont des cables en cuivre fichés dans des `transceiver`. Ils permettent à deux ports SFP/SFP+ de dialoguer, à courte distance, sans utiliser une fibre plus fragile ou d'adapteteur RJ45. Cependant, ils demandent plus d'énergie, la deperdition dans le cuivre etant non négligeable. +Ce sont des câbles en cuivre fichés dans des `transceiver`. Ils permettent à deux ports SFP/SFP+ de dialoguer, à courte distance, sans utiliser une fibre plus fragile ou d'adaptateur RJ45. Cependant, ils demandent plus d'énergie, la déperdition dans le cuivre étant non négligeable. ### Les transceiver SFP+ -Ils permettent de connecter différents types de cables à vos ports SFP/SFP+. Il en existe pour : +Ils permettent de connecter différents types de câbles à vos ports SFP/SFP+. Il en existe pour : - la fibre optique - le DAC @@ -117,5 +117,5 @@ Ils permettent de connecter différents types de cables à vos ports SFP/SFP+. I ::warning -__Attention :__ Un transceiver RJ45 consommera beaucoup d'energie due à la deperdition naturelle dans le cuivre, et donc génerera beaucoup de chaleur. Il existe des transceiver basse consommation, consommant moins de 2W. De manière peu intuitive, ils sont généralement indiqués pour des cables plus long (80m au lieu de 30m). Ils sont conseillés plutot que ceux indiqués pour les cables plus court car ces derniers dégagent plus de chaleur et demandent plus d'energie, ce qui peut poser des problemes de compatibilité avec votre matériel, et dégrader votre réseau, voir le couper. +__Attention :__ Un transceiver RJ45 consommera beaucoup d'énergie due à la déperdition naturelle dans le cuivre, et donc générera beaucoup de chaleur. Il existe des transceiver basse consommation, consommant moins de 2W. De manière peu intuitive, ils sont généralement indiqués pour des câbles plus longs (80m au lieu de 30m). Ils sont conseillés plutôt que ceux indiqués pour les câbles plus courts car ces derniers dégagent plus de chaleur et demandent plus d'énergie, ce qui peut poser des problèmes de compatibilité avec votre matériel, et dégrader votre réseau, voire le couper. :: diff --git a/content/fr/2.general/4.hardware/3.prolonas.md b/content/fr/2.general/4.hardware/3.prolonas.md index 00a7d15..d0593e6 100644 --- a/content/fr/2.general/4.hardware/3.prolonas.md +++ b/content/fr/2.general/4.hardware/3.prolonas.md @@ -12,7 +12,7 @@ Cet article a été écrit avant l'augmentation __massive__ des prix du matérie Lorsque l'on se lance dans l'aventure de son serveur chez soi, on se pose souvent la question _« Avec quoi dois-je commencer ? »_, _« Cela coûte cher non ? »_, et on finit soit par ne pas le faire, soit par acheter un NAS propriétaire qu'on jettera à la poubelle au bout d'un an quand on aura compris que cela n'apporte rien à part des problèmes et de l'argent jeté par la fenêtre. -Un serveur, ce n'est pas une armoire. C'est n'importe quel ordinateur capable de faire tourner linux. C'est pour cela que les mini PC à base de processeurs N100 sont populaires. Pour 100-130€ sur des plateformes chinoises on a une machine sous linux capable de tourner H24 des années durant, et d'executer tout ce qu'on attend d'un serveur/cloud chez soi sans perdre en performances. +Un serveur, ce n'est pas une armoire. C'est n'importe quel ordinateur capable de faire tourner linux. C'est pour cela que les mini PC à base de processeurs N100 sont populaires. Pour 100-130€ sur des plateformes chinoises on a une machine sous linux capable de tourner H24 des années durant, et d'exécuter tout ce qu'on attend d'un serveur/cloud chez soi sans perdre en performances. Ce n'est objectivement pas cher et n'importe qui s'intéressant au sujet peut se lancer dans l'aventure. @@ -32,11 +32,11 @@ C'est tout simplement ça le **ProloNAS, un NAS accessible pour les prolo**. Cha ## Pourquoi un NAS ? -Un NAS (Network Attached Storage), c'est une machine conçue autour d'un espace de stockage ayant vocation a être partagé sur un réseau. L'idée du NAS, c'est d'avoir un stockage fiable et sécurisé sur lequel s'appuie nos usages et nos applicatifs comme des données cloud par exemple (un drive comme [Nextcloud](/serveex/cloud/nextcloud), une synchro photo comme [Immich](/serveex/cloud/immich). Mais aussi vos media comme vos films (par exemple avec [Jellyfin](/serveex/media/jellyfin)) ou les videos de vos caméra de surveillance. +Un NAS (Network Attached Storage), c'est une machine conçue autour d'un espace de stockage ayant vocation à être partagé sur un réseau. L'idée du NAS, c'est d'avoir un stockage fiable et sécurisé sur lequel s'appuie nos usages et nos applicatifs comme des données cloud par exemple (un drive comme [Nextcloud](/serveex/cloud/nextcloud), une synchro photo comme [Immich](/serveex/cloud/immich)). Mais aussi vos media comme vos films (par exemple avec [Jellyfin](/serveex/media/jellyfin)) ou les vidéos de vos caméras de surveillance. ### Mais pourquoi un Mini PC avec un disque dur externe ne suffirait-il pas ? -Bien sûr, un simple mini PC avec ses 1 à 2To de stockage devraient suffire pour la plupart des gens. Et les films pourraient tenir dans un disque dur externe de quelques TB supplémentaire. En revanche ce n'est pas une solution fiable ni extensible de faire tourner ses applications et usages sur du stockage qui au moindre choc, au moindre probleme, fait perdre vos données définitivement. +Bien sûr, un simple mini PC avec ses 1 à 2To de stockage devraient suffire pour la plupart des gens. Et les films pourraient tenir dans un disque dur externe de quelques TB supplémentaires. En revanche ce n'est pas une solution fiable ni extensible de faire tourner ses applications et usages sur du stockage qui au moindre choc, au moindre problème, fait perdre vos données définitivement. Le vrai NAS est construit autour de la fiabilité du support qui contient vos données. Il nécessite de mettre en place des stratégies de stockages type [RAID](/general/storage/raid) afin de préserver vos données en cas de panne et de la sauvegarde en cas de corruption (comme les snapshot [ZFS](/general/storage/zfs)). @@ -50,25 +50,25 @@ De nombreuses marques proposent des plateformes prêtes à accueillir vos disque 350€, c'est le prix de départ d'un NAS 2 baies (sans les disques) chez Syno, avec un processeur qui date de 2019, pas de logement pour un SSD pour l'OS, et 2 pauvres giga-octets de RAM. -Rappelez vous le **ProloNAS** : un N100 4 coeurs, 16Go de RAM, un SSD de 512Go, pour 100-130€ et un DAS 4 baies à 55€. Soit deux fois moins que le Syno 2 baies, 4 fois moins que le Syno 4 baies. +Rappelez vous le **ProloNAS** : un N100 4 cœurs, 16Go de RAM, un SSD de 512Go, pour 100-130€ et un DAS 4 baies à 55€. Soit deux fois moins que le Syno 2 baies, 4 fois moins que le Syno 4 baies. ### OS limités « Oui mais ok l'argument du prix, mais au moins tu lances le truc et c'est bon, t'as de jolies applications qui tournent toute seule sans maintenance ». Une année. -Une année c'est le temps qu'il m'a fallu pour jeter à la poubelle mon Syno en me disant que j'aurais du dès le départ partir sur mon **ProloNAS** (devenu un vrai serveur, depuis). +Une année c'est le temps qu'il m'a fallu pour jeter à la poubelle mon Syno en me disant que j'aurais dû dès le départ partir sur mon **ProloNAS** (devenu un vrai serveur, depuis). -Les constructeurs vous mettent à disposition des OS linux customisés à leur sauce, ne partageant pas les catalogues d'applications linux des distributions majeures, avec des noyaux linux datant souvent de l'antiquité, et surtout des OS tres fermés ne vous permettant pas de développer votre NAS exactement selon vos besoins. En gros, soit vous utilisez leurs applications, soit vous rentrer dans un monde de souffrance. Pour donner un exemple, de nombreux conteneurs docker ne fonctionnent pas sur ces NAS constructeurs car le kernel est tellement vieux qu'il ne peut supporter les versions pourtant pas toujours récentes de docker. +Les constructeurs vous mettent à disposition des OS linux customisés à leur sauce, ne partageant pas les catalogues d'applications linux des distributions majeures, avec des noyaux linux datant souvent de l'antiquité, et surtout des OS très fermés ne vous permettant pas de développer votre NAS exactement selon vos besoins. En gros, soit vous utilisez leurs applications, soit vous rentrez dans un monde de souffrance. Pour donner un exemple, de nombreux conteneurs docker ne fonctionnent pas sur ces NAS constructeurs car le kernel est tellement vieux qu'il ne peut supporter les versions pourtant pas toujours récentes de docker. -### Dépendance des mises à jours propriétaires +### Dépendance des mises à jour propriétaires « Oui mais moi j'ai pas d'autre usages que ce que leurs applicatifs natifs proposent ». -Oui oui, moi aussi j'ai cru ça. Mais 1 an après mon Syno, mes usages ont explosés. Media center, gestion de mot de passe, plateforme git, plateforme de développement, Authentification forte et SSO hébergement web... Pourquoi etre bloqués par les solutions constructeurs jamais excellentes, souvent baclées et compatibles avec rien ? +Oui oui, moi aussi j'ai cru ça. Mais 1 an après mon Syno, mes usages ont explosé. Media center, gestion de mot de passe, plateforme git, plateforme de développement, Authentification forte et SSO hébergement web... Pourquoi être bloqués par les solutions constructeurs jamais excellentes, souvent bâclées et compatibles avec rien ? -D'autre part, ces applicatifs, vous devenez dépendant de la bonne volonté du constructeur, en terme de sécurité, de mises à jour, et de disponibilités. Je préfère confier cette dépendance à des projets open-source, mis à jour plus régulièrement et ne dépendant pas de la bonne volonté d'un board commercial. +D'autre part, avec ces applicatifs propriétaires, vous devenez dépendant de la bonne volonté du constructeur, en terme de sécurité, de mises à jour, et de disponibilité. Je préfère confier cette dépendance à des projets open-source, mis à jour plus régulièrement et ne dépendant pas de la bonne volonté d'un board commercial. -Et cela ne s'arrête pas là, qui vous dit que les disques dur que vous avez inséré dans ces NAS proproietaires vont etre supportés ? Synology a rendu incompatible son matériel avec les marques n'ayant pas un partenariat avec eux, afin de booster la vente de leurs propres disques. Qui vous dit que votre media center pourra profiter des performances de l'iGPU de votre processeur pour streamer vos media vers vos appareils ? [Synology a désactivé le transcodage matériel de ses NAS](https://www.cachem.fr/synology-desactive-transcodage-materiel-nas/). +Et cela ne s'arrête pas là, qui vous dit que les disques dur que vous avez inséré dans ces NAS propriétaires vont être supportés ? Synology a rendu incompatible son matériel avec les marques n'ayant pas un partenariat avec eux, afin de booster la vente de leurs propres disques. Qui vous dit que votre media center pourra profiter des performances de l'iGPU de votre processeur pour streamer vos media vers vos appareils ? [Synology a désactivé le transcodage matériel de ses NAS](https://www.cachem.fr/synology-desactive-transcodage-materiel-nas/). Bref, vous n'avez aucun pouvoir sur un produit qui n'est pas réellement ni ouvert ni à vous. diff --git a/content/fr/2.general/5.linux/1.cli-basics.md b/content/fr/2.general/5.linux/1.cli-basics.md index 3e6aee8..ce1a5ac 100644 --- a/content/fr/2.general/5.linux/1.cli-basics.md +++ b/content/fr/2.general/5.linux/1.cli-basics.md @@ -6,9 +6,9 @@ description: Comprendre comment une commande Linux est construite, apprendre les :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -Un serveur n'a pas de bureau, pas d'icônes et pas de souris. Tout se passe dans un terminal, et cette fenêtre noire avec un curseur clignotant est principalement ce qui décourage les gens de se lancer de le self-hosting. À tort : le terminal n'est qu'un chat. Vous posez une question ou écrivez un ordre, la machine répond. Rien de plus complexe qu'une barre de recherche, sauf qu'il en fait bien plus et ne cache jamais une option derrière trois menus. +Un serveur n'a pas de bureau, pas d'icônes et pas de souris. Tout se passe dans un terminal, et cette fenêtre noire avec un curseur clignotant est principalement ce qui décourage les gens de se lancer dans le self-hosting. À tort : le terminal n'est qu'un chat. Vous posez une question ou écrivez un ordre, la machine répond. Rien de plus complexe qu'une barre de recherche, sauf qu'il en fait bien plus et ne cache jamais une option derrière trois menus. -La bonne nouvelle, c'est que vous n'avez pas besoin de connaître des centaines de commandes. Une dizaine d'entre elles couvrent presque tout vos besoins sur un serveur maison, et elles suivent toutes le même schéma. Apprenez à lire ce schéma et chaque commande que vous croiserez par la suite deviendra lisible, même celles que vous n'avez jamais vues. +La bonne nouvelle, c'est que vous n'avez pas besoin de connaître des centaines de commandes. Une dizaine d'entre elles couvrent presque tous vos besoins sur un serveur maison, et elles suivent toutes le même schéma. Apprenez à lire ce schéma et chaque commande que vous croiserez par la suite deviendra lisible, même celles que vous n'avez jamais vues. ## Comment une commande est construite @@ -108,7 +108,7 @@ La première colonne, ce sont les permissions, le `d` tout au début signifiant ### `cd`, change directory -Permet de changer de repertoire. Lorsque vous indiquez un chemin, elle vous y rend. Avec `..` elle remonte d'un niveau, et sans rien du tout elle vous ramène dans votre dossier utilisateur. +Permet de changer de répertoire. Lorsque vous indiquez un chemin, elle vous y emmène. Avec `..` elle remonte d'un niveau, et sans rien du tout elle vous ramène dans votre dossier utilisateur. ```console [Terminal] utilisateur@serveex:~/docker$ cd /var/log @@ -149,7 +149,7 @@ ls compose.yaml compose.yaml.bak config config-backup nouveau-nom.txt ``` -Trois commandes silencieuses, et `ls` qui montre le résultat : la copie est à côté de l'original, le dossier a été dupliqué, et `ancien-nom.txt` a disparu parce que le déplacer vers un autre nom équivaut à le renommer/ +Trois commandes silencieuses, et `ls` qui montre le résultat : la copie est à côté de l'original, le dossier a été dupliqué, et `ancien-nom.txt` a disparu parce que le déplacer vers un autre nom équivaut à le renommer. ### `rm`, remove @@ -211,7 +211,7 @@ sudo nano /etc/ssh/sshd_config ``` ::note -Lordsqu'une commande répond `Permission denied`, c'est quasiment certain que c'est parce qu'elle a besoin des privilèges administrateurs : il lui fallait `sudo`. Cependant, résistez tout de même au réflexe de mettre `sudo` partout, un fichier créé avec les privilèges root continuera de vous embêter par la suite parce que votre utilisateur normal n'en sera plus propriétaire. +Lorsqu'une commande répond `Permission denied`, c'est quasiment certain que c'est parce qu'elle a besoin des privilèges administrateurs : il lui fallait `sudo`. Cependant, résistez tout de même au réflexe de mettre `sudo` partout, un fichier créé avec les privilèges root continuera de vous embêter par la suite parce que votre utilisateur normal n'en sera plus propriétaire. :: ## Aide-mémoire diff --git a/content/fr/2.general/5.linux/2.filesystem.md b/content/fr/2.general/5.linux/2.filesystem.md index 3fc2fbe..5edb28a 100644 --- a/content/fr/2.general/5.linux/2.filesystem.md +++ b/content/fr/2.general/5.linux/2.filesystem.md @@ -6,11 +6,11 @@ description: Comment le système de fichiers de Debian est organisé, ce que con :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -Windows donne à chaque disque sa propre lettre. Linux non : il y a un arbre, il commence à `/`, la racine (root), et tout le reste s'y accroche, y compris vos autres disques. Un deuxième disque n'est pas `D:`, il est *monté* sur un dossier de l'arbre, `/mnt/data` par exemple, et à partir de là il ressemble à n'importe quel autre dossier. Cela peut paraître éroutant au début, mais très pratique ensuite, puisqu'un programme n'a jamais à savoir sur quel disque physique il écrit. +Windows donne à chaque disque sa propre lettre. Linux non : il y a un arbre, il commence à `/`, la racine (root), et tout le reste s'y accroche, y compris vos autres disques. Un deuxième disque n'est pas `D:`, il est *monté* sur un dossier de l'arbre, `/mnt/data` par exemple, et à partir de là il ressemble à n'importe quel autre dossier. Cela peut paraître déroutant au début, mais très pratique ensuite, puisqu'un programme n'a jamais à savoir sur quel disque physique il écrit. ## L'arborescence -Cet arborescence n'a rien d'arbitraire. Toutes les installations de Debian sont organisées de la même manière, et c'est pour ça qu'un tutoriel écrit pour le serveur de quelqu'un d'autre s'applique également au vôtre. +Cette arborescence n'a rien d'arbitraire. Toutes les installations de Debian sont organisées de la même manière, et c'est pour ça qu'un tutoriel écrit pour le serveur de quelqu'un d'autre s'applique également au vôtre. | Dossier | Ce qu'il contient | | --- | --- | @@ -46,13 +46,13 @@ sdb 8:16 0 3.6T 0 disk ## Quelques habitudes à prendre -- **Ne travaillez que dans un seul dossier pour l'usage de votre serveur.** `/srv` est le dossier que la norme réserve aux données servies par la machine, ce qui en fait l'endroit le plus propre pour mettre les sous dossiers et fichiers dont vous avez besoin de stocker sur votre serveur. Par exemple pour Docker, [Serveex](/serveex/introduction) met tout dans `/srv/docker`, un dossier par stack. Ce qui compte, c'est de choisir un endroit et de s'y tenir, plutôt que d'en éparpiller la moitié dans votre dossier personnel ou pire, dans les dossiers de Debian et directement à la racine. +- **Ne travaillez que dans un seul dossier pour l'usage de votre serveur.** `/srv` est le dossier que la norme réserve aux données servies par la machine, ce qui en fait l'endroit le plus propre pour mettre les sous dossiers et fichiers que vous avez besoin de stocker sur votre serveur. Par exemple pour Docker, [Serveex](/serveex/introduction) met tout dans `/srv/docker`, un dossier par stack. Ce qui compte, c'est de choisir un endroit et de s'y tenir, plutôt que d'en éparpiller la moitié dans votre dossier personnel ou pire, dans les dossiers de Debian et directement à la racine. - **Vos fichiers à vous, propre à un utilisateur, vont dans votre home.** Les scripts dans `~/bin`, les notes, les téléchargements, tout ce qui est personnel. `/root` est le dossier du compte root, pas un endroit commode où déposer des choses. - **Ne modifiez jamais quoi que ce soit sous `/usr` ou `/bin` à la main.** `apt` en est propriétaire, et vos changements disparaîtront à la prochaine mise à jour. Ce que vous avez le droit de configurer vit dans `/etc`. - **Dans `/etc`, préférez créer un fichier additionnel plutôt que de modifier le principal.** Beaucoup de services lisent tous les `.conf` d'un dossier `quelquechose.d/` posé à côté de leur config principale, `/etc/ssh/sshd_config.d/` par exemple. Votre fichier survit alors à une mise à jour de paquet qui réécrirait l'original. - **Montez les disques de données par UUID, pas par `/dev/sdb`.** Les lettres de périphérique sont attribuées dans l'ordre où le noyau trouve les disques, elles peuvent donc s'échanger après un redémarrage ou l'ajout d'un disque. `lsblk -f` vous donne l'UUID à mettre dans `/etc/fstab`. - **Gardez un œil sur `/var`.** Les images Docker, les logs des conteneurs et ceux du système s'y accumulent tous, sur la même partition que le reste. `du -sh /var/lib/docker` vous dit ce que pèsent les conteneurs, `df -h` s'il faut s'inquiéter. -- **Ne créez pas vos fichiers avec `sudo` lorque ce n'est pas nécessaire.** Un fichier créé en root dans votre home reste la propriété de root, et vous vous battrez avec des erreurs de permissions dessus pendant des semaines. +- **Ne créez pas vos fichiers avec `sudo` lorsque ce n'est pas nécessaire.** Un fichier créé en root dans votre home reste la propriété de root, et vous vous battrez avec des erreurs de permissions dessus pendant des semaines. ::note{to="/general/linux/cli-basics"} Tout ce qui précède suppose que vous savez déjà vous déplacer dans un terminal. Si `cd`, `ls` et `sudo` ne vous parlent pas encore, commencez par les **bases de la ligne de commande**. diff --git a/content/fr/2.general/5.linux/3.handy-tools.md b/content/fr/2.general/5.linux/3.handy-tools.md index 4c6cbd1..180fb47 100644 --- a/content/fr/2.general/5.linux/3.handy-tools.md +++ b/content/fr/2.general/5.linux/3.handy-tools.md @@ -196,7 +196,7 @@ La casse compte : `E` ouvre un shell dans le conteneur, `e` masque ceux qui sont La [liste complète](https://github.com/jesseduffield/lazydocker/blob/master/docs/keybindings/Keybindings_en.md) se trouve dans la documentation du projet. ::note -N'etant pas un package de Debian signifie qu'il ne sera pas mis à jour par `apt full-upgrade`. Ré-éxecutez ces étapes lorsque vous voudrez une version plus récente. +Ne pas être un paquet Debian signifie qu'il ne sera pas mis à jour par `apt full-upgrade`. Réexécutez ces étapes lorsque vous voudrez une version plus récente. :: #### Terminé ! diff --git a/content/fr/3.serveex/2.core/1.installation.md b/content/fr/3.serveex/2.core/1.installation.md index 79bf8fb..fd0495c 100644 --- a/content/fr/3.serveex/2.core/1.installation.md +++ b/content/fr/3.serveex/2.core/1.installation.md @@ -203,7 +203,7 @@ sudo systemctl restart ssh ``` ::warning -Gardez votre session SSH actuelle ouverte pendant le test. Ouvrez un **second** terminal et reconnectez-vous : si la clé ne fonctionne plus, la session restée ouverte est votre porte de secours pour corriger la configuration. Si vous la fermez avant d'avoir vérifié et une faute de frappe vous enferme en dehors de votre propre serveur, avec l'écran et le clavier comme seul recours. +Gardez votre session SSH actuelle ouverte pendant le test. Ouvrez un **second** terminal et reconnectez-vous : si la clé ne fonctionne plus, la session restée ouverte est votre porte de secours pour corriger la configuration. Si vous la fermez avant d'avoir vérifié et qu'une faute de frappe vous enferme en dehors de votre propre serveur, l'écran et le clavier deviennent votre seul recours. :: ::note diff --git a/content/fr/3.serveex/2.core/3.wireguard.md b/content/fr/3.serveex/2.core/3.wireguard.md index 50b9688..d11dd05 100644 --- a/content/fr/3.serveex/2.core/3.wireguard.md +++ b/content/fr/3.serveex/2.core/3.wireguard.md @@ -7,11 +7,11 @@ description: Installer et configurer WireGuard VPN pour accéder à votre homela :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} ## Introduction -L'utilisation d'un VPN permet d'accéder à distance aux ressources locales du serveur sans les exposer sur internet. C'est notamment une manière propre de sécuriser l'accès à la console SSH, plutot que d'exposer le port sur internet. C'est pouvoir se connecter à son réseau où que l'on soit, de maniere sécurisée, et de faire dialoguer des machines qui sont sur des réseaux différents. +L'utilisation d'un VPN permet d'accéder à distance aux ressources locales du serveur sans les exposer sur internet. C'est notamment une manière propre de sécuriser l'accès à la console SSH, plutôt que d'exposer le port sur internet. C'est pouvoir se connecter à son réseau où que l'on soit, de manière sécurisée, et de faire dialoguer des machines qui sont sur des réseaux différents. Ici nous utiliserons [Wireguard](https://www.wireguard.com/), un serveur VPN sécurisé et très performant, à l'aide des conteneurs : -- [wg-easy](https://github.com/wg-easy/wg-easy) pour le serveur, qui propose une interface web très simple pour controler les connexions et télécharger les fichiers de conf (notamment par QR code pour les téléphones) +- [wg-easy](https://github.com/wg-easy/wg-easy) pour le serveur, qui propose une interface web très simple pour contrôler les connexions et télécharger les fichiers de conf (notamment par QR code pour les téléphones) - [Wireguard](https://docs.linuxserver.io/images/docker-wireguard/?h=wireguard) pour les clients linux Il existe aussi des clients Windows, MacOS, iOS et Android. @@ -19,13 +19,13 @@ Il existe aussi des clients Windows, MacOS, iOS et Android. Le principe est le suivant : - Sur internet, n'importe qui peut contacter n'importe quel box internet et donc essayer de contacter n'importe quel serveur exposé. -- Votre serveur est sur votre réseau local. Il est accessible depuis le réseau local mais pas depuis internet, mis à part les services exposés (comme nous l'avons fait avec Dockge). Pour accéder aux ressources non exposées, vous devez être connecté sur le meme réseau que votre serveur et donc etre chez vous. De plus, vous devez laisser ouvert les ports utilisés par vos services à travers le pare feu de votre serveur. -- Nous souhaitons ici au contraire, depuis n'importe où, pouvoir accéder de maniere securisée aux services non exposés sur internet du serveur, comme la console SSH qui permet de se connecter à la machine par exemple. -- Nous souhaitons aussi accéder aux services d'autres serveurs, et par exemple relier de maniere sécurisée deux instances de Dockge pour tout controler depuis la meme interface. +- Votre serveur est sur votre réseau local. Il est accessible depuis le réseau local mais pas depuis internet, mis à part les services exposés (comme nous l'avons fait avec Dockge). Pour accéder aux ressources non exposées, vous devez être connecté sur le même réseau que votre serveur et donc être chez vous. De plus, vous devez laisser ouvert les ports utilisés par vos services à travers le pare feu de votre serveur. +- Nous souhaitons ici au contraire, depuis n'importe où, pouvoir accéder de manière sécurisée aux services non exposés sur internet du serveur, comme la console SSH qui permet de se connecter à la machine par exemple. +- Nous souhaitons aussi accéder aux services d'autres serveurs, et par exemple relier de manière sécurisée deux instances de Dockge pour tout contrôler depuis la même interface. -Pour cela nous allons créer un **réseau privé virtuel**, ou VPN, c'est à dire un tunnel sécurisé auquel personne n'a accès à part les machines que vous relierez entre elles. Elles feront partie d'un nouveau réseau et pourront dialoguer entre elle comme dans un réseau local. +Pour cela nous allons créer un **réseau privé virtuel**, ou VPN, c'est-à-dire un tunnel sécurisé auquel personne n'a accès à part les machines que vous relierez entre elles. Elles feront partie d'un nouveau réseau et pourront dialoguer entre elle comme dans un réseau local. -D'autre part, vous pourrez ajouter votre téléphone, un ordinateur portable ou n'importe quel appareil au réseau pour pouvoir utiliser vos ressources depuis vos appareils quotidiens, où que vous soyiez. +D'autre part, vous pourrez ajouter votre téléphone, un ordinateur portable ou n'importe quel appareil au réseau pour pouvoir utiliser vos ressources depuis vos appareils quotidiens, où que vous soyez. ![picture](/img/serveex/vpn.svg) @@ -34,7 +34,7 @@ Dans cette illustration, la machine 1 est sur deux réseaux : - son réseau local (tous les appareils liés à la box, avec une adresse IP du type `192.168.x.x ` donc ici la machine 1 et la machine 2) - le réseau du VPN (tous les appareils reliés au VPN, avec une seconde adresse IP du type `10.8.x.x` donc ici la machine 1 et 4) -On peut aussi faire en sorte que les machines reliées au réseau virtuel partagent les acces à leur réseau local. Ici nous ne le ferons pas, pour des raisons de sécurité, et de complexité en terme de sous-réseau (si les deux machines distantes ont des machines locales qui utilisent la meme adresse IP locale, par exemple `192.168.1.1`, cela posera des conflits). +On peut aussi faire en sorte que les machines reliées au réseau virtuel partagent les accès à leur réseau local. Ici nous ne le ferons pas, pour des raisons de sécurité, et de complexité en terme de sous-réseau (si les deux machines distantes ont des machines locales qui utilisent la même adresse IP locale, par exemple `192.168.1.1`, cela posera des conflits). Ainsi, sur le réseau virtuel, seules les machines directement reliées pourront dialoguer entre elle depuis ce réseau. Elles ne pourront pas dialoguer avec une machine situées sur un autre réseau local et non reliée au VPN. diff --git a/content/fr/3.serveex/3.security/2.cloudflare.md b/content/fr/3.serveex/3.security/2.cloudflare.md index b098f72..08c9d23 100644 --- a/content/fr/3.serveex/3.security/2.cloudflare.md +++ b/content/fr/3.serveex/3.security/2.cloudflare.md @@ -15,9 +15,9 @@ Les _tunnels Cloudflare_ offrent un moyen simple d'arriver au _Zero Trust_, en s Pour le dire simplement, les Tunnels Cloudflare permettent notamment de : - Masquer l'IP de votre serveur (et donc de votre box s'il est hébergé chez vous). -- D'authentifier le traffic. -- De bénéficier des protection de Cloudflare (attaques DDOS, etc, blacklist, requêtes malveillantes, etc...). -- De bénéficier du CDN, c'est à dire du serveur de cache de Cloudlfare, qui permet d'augmenter les performances de vos sites web. +- D'authentifier le trafic. +- De bénéficier des protections de Cloudflare (attaques DDOS, etc, blacklist, requêtes malveillantes, etc.). +- De bénéficier du CDN, c'est-à-dire du serveur de cache de Cloudflare, qui permet d'augmenter les performances de vos sites web. - De ne plus avoir besoin de l'ouverture de ports de votre routeur pour les services exposés par SWAG. Ici, nous expliquerons comment associer SWAG aux tunnels Cloudflare. @@ -34,11 +34,11 @@ __Attention :__ Avant toute chose, vous devez définir Cloudflare comme gestionnaire de votre [zone DNS](/general/networking/dns). Si vous avez réservé votre nom de domaine chez Cloudflare, c'est déjà le cas. Sinon, renseignez vous auprès de votre registrar sur comment ajouter des DNS externes. Cloudflare dispose d'[une documentation expliquant pas à pas comment paramétrer une Zone DNS](https://developers.cloudflare.com/dns/zone-setups/full-setup/setup/), que vous ayez un domaine externe ou reservé chez Cloudflare. -Si vous avez qu'un seul serveur à protéger derrière Cloudflare, vous pouvez supprimer l'ensemble des enregistrement DNS existant, par défaut le domaine et tout ses sous-domaines seront directement redirigés vers le tunnel. +Si vous n'avez qu'un seul serveur à protéger derrière Cloudflare, vous pouvez supprimer l'ensemble des enregistrements DNS existants, par défaut le domaine et tous ses sous-domaines seront directement redirigés vers le tunnel. Si vous avez des sous-domaines à rediriger vers d'autres serveurs, vous pourrez toujours les déclarer dans la zone DNS à l'aide d'un enregistrement A. -Si vous avez plusieurs serveurs et donc plusieurs tunnels pour un meme domaine principal, [voyez ici](#gérer-plusieurs-tunnels-pour-plusieurs-serveurs). +Si vous avez plusieurs serveurs et donc plusieurs tunnels pour un même domaine principal, [voyez ici](#gérer-plusieurs-tunnels-pour-plusieurs-serveurs). ### Clé API @@ -69,7 +69,7 @@ Nous partons du principe que vous avez le domaine `mondomaine.fr` avec les DNS q SWAG dispose de deux `Docker Mods` permettant d'y intégrer : - __Cloudflared__, le conteneur qui permet de créer et de gérer les tunnels -- __Cloudflared Real IP__, un conteneur qui permet à SWAG d'obtenir la vraie source IP des requêtes depuis internet plutot que celle de Docker (ce qui pourrait entrer en conflit avec le mod de géolocalisatioN DBIP). +- __Cloudflared Real IP__, un conteneur qui permet à SWAG d'obtenir la vraie source IP des requêtes depuis internet plutôt que celle de Docker (ce qui pourrait entrer en conflit avec le mod de géolocalisation DBIP). Ces deux mods, fusionnés dans le conteneur de SWAG, nécessitent un peu de configuration. @@ -211,9 +211,9 @@ TUNNEL_PW= | `TUNNEL_NAME`{lang=properties} | Le nom de votre tunnel | `mon_tunnel` | | `TUNNEL_PW`{lang=properties} | Un mot de passe fort généré aléatoirement | `iSzKRmP4VbnlsMvdSdgBEJiJi` | -Une fois fait, déployez la stack. Cela prendra un peu de temps, vérifiez les logs, vous devriez arriver à `serveur ready` +Une fois fait, déployez la stack. Cela prendra un peu de temps, vérifiez les logs, vous devriez arriver à `server ready`. -Une fois le conteneur en ligne, vérifiez dans cloudflare que votre tunnel est bien présent dans la section _Networks > Tunnels_ de [Cloudflare Zero Trust](https://one.dash.cloudflare.com/). Par défaut, l'ensemble des sous domaine sont redirigés vers le tunnel, sans avoir besoin de les déclarer [dans votre zone DNS](/general/networking/dns). +Une fois le conteneur en ligne, vérifiez dans cloudflare que votre tunnel est bien présent dans la section _Networks > Tunnels_ de [Cloudflare Zero Trust](https://one.dash.cloudflare.com/). Par défaut, l'ensemble des sous-domaines sont redirigés vers le tunnel, sans avoir besoin de les déclarer [dans votre zone DNS](/general/networking/dns). ::tip{icon="" to="/general/networking/dns"} ✨ __Astuce :__ si vous voulez exposer un service sans tunnel, déclarez simplement un enregistrement A **dans votre zone DNS**. En cas de problème de résolution, désactivez la fonction _proxy_ pour cet enregistrement, par exemple pour `sous.mondomaine.fr`. @@ -249,7 +249,7 @@ Dans le [tableau de bord DNS de Cloudflare](https://dash.cloudflare.com/), cliqu ### Terminé ! :: -Si vous avez de nombreux sous-domaines, vous pouvez déclarer un seul sous domaine par tunnel comme ci-dessus, puis déclarer vos autres sous domaine en les faisant pointer vers ces sous domaines de référence. +Si vous avez de nombreux sous-domaines, vous pouvez déclarer un seul sous-domaine par tunnel comme ci-dessus, puis déclarer vos autres sous-domaines en les faisant pointer vers ces sous-domaines de référence. Ainsi, en cas de changement d'ID de tunnel, vous n'aurez qu'un seul enregistrement DNS à modifier. diff --git a/content/fr/3.serveex/9.apps/1.adguard.md b/content/fr/3.serveex/9.apps/1.adguard.md index b1b99c9..0054c49 100644 --- a/content/fr/3.serveex/9.apps/1.adguard.md +++ b/content/fr/3.serveex/9.apps/1.adguard.md @@ -6,7 +6,7 @@ description: Installer AdGuard Home pour bloquer publicités et trackers à l'é :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -[AdGuard Home](https://github.com/AdguardTeam/AdGuardHome) est un serveur DNS anti-pub et anti-traçage qui fonctionne au niveau du système. Une fois configuré, il couvrira TOUS vos appareils domestiques et vous n'aurezbesoin d'aucun logiciel côté client pour cela. +[AdGuard Home](https://github.com/AdguardTeam/AdGuardHome) est un serveur DNS anti-pub et anti-traçage qui fonctionne au niveau du système. Une fois configuré, il couvrira TOUS vos appareils domestiques et vous n'aurez besoin d'aucun logiciel côté client pour cela. Il fonctionne comme un serveur DNS qui redirige les domaines de suivi vers un «black hole», empêchant ainsi vos appareils de se connecter à ces serveurs. @@ -18,12 +18,12 @@ En pratique, une fois en place, il vous faudra juste configurer les serveurs DNS Lorsque vous naviguez sur un site, ou une application, des requêtes sont émises vers un ou des domaines afin d'afficher le contenu de votre page. Les publicités notamment. Votre appareil ne connait pas les adresses IP de ces serveurs à joindre. Pour les connaitre, il va contacter un _serveur de nom_ (Domain Name Server) qui lui va lui répondre avec l'adresse IP la plus à jour pour le domaine de la requête. -Par défaut, votre appareil utilise le serveur votre fournisseur d'accès, paramétré dans votre box ou directement sur le CGNAT de votre opérateur si appareil mobile. Cela peut etre changé directement dans les réglages de votre navigateur, mais aussi dans le système de votre appareil, et parfois directement dans votre box si votre FAI le permet. +Par défaut, votre appareil utilise le serveur de votre fournisseur d'accès, paramétré dans votre box ou directement sur le CGNAT de votre opérateur si appareil mobile. Cela peut être changé directement dans les réglages de votre navigateur, mais aussi dans le système de votre appareil, et parfois directement dans votre box si votre FAI le permet. -Adguard lui, va s'intercaler entre le serveur de nom et votre appareil. Si vous paramétrez vos appareil, ils contacteront d'abord adguard qui filtrera les requetes, via des listes régulièrement mises à jour : +Adguard lui, va s'intercaler entre le serveur de nom et votre appareil. Si vous paramétrez vos appareil, ils contacteront d'abord adguard qui filtrera les requêtes, via des listes régulièrement mises à jour : - Si le domaine n'est pas dans une blocklist, il contactera des serveurs de noms génériques (dit upstreams) et répondra vers vos appareils avec l'adresse IP recherchée. -- Si le domaine est dans une blocklist, il ne contactera pas les DNS upstream et ne répondre pas à vos appareils. Le contenu affilié à cette requete ne s'affichera pas. +- Si le domaine est dans une blocklist, il ne contactera pas les DNS upstream et ne répondra pas à vos appareils. Le contenu affilié à cette requête ne s'affichera pas. C'est ainsi que les pubs et domaines malveillants sont bloqués : leurs domaines sont présents dans la blocklist, le reste de la page lui charge correctement. @@ -347,7 +347,7 @@ Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWA

Vous pouvez protéger cette app avec Authentik en ouvrant `adguard.subdomain.conf` et en retirant les `#` devant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. n'oubliez pas de [créer une application et un fournisseur dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). Il vous faudra exclure l'url `https://adguard.mondomaine.fr/dns-query` de l'authentification : -- Editez le fournisseur d'Adguard +- Éditez le fournisseur d'Adguard - Dans *paramètres avancés du protocole > chemins authentifiés*, saisissez `^/dns-query` :: @@ -356,19 +356,19 @@ Enregistrez avec :kbd{value="Ctrl+O"} puis :kbd{value="Entrée"}, puis quittez a Et voilà, vous exposez Adguard à présent ! ## Configurer le chiffrement SSL/TLS -Le chiffrement est essentiel si vous souhaitez garder privées les requêtes que vous faites vers adguard. Chiffrer ces requêtes c'est vous assurez que personne, meme votre FAI ne connaissent votre historique. C'est aussi vous assurer que personne d'autre que votre serveur vous répond. +Le chiffrement est essentiel si vous souhaitez garder privées les requêtes que vous faites vers adguard. Chiffrer ces requêtes c'est vous assurer que personne, même votre FAI, ne connaisse votre historique. C'est aussi vous assurer que personne d'autre que votre serveur vous répond. Afin de configurer le chiffrement : - Allez dans _paramètre_ puis dans _chiffrement_. -- Parametrez comme suit +- Paramétrez comme suit ![Picture](/img/serveex/adguard-chiffrement.png) - Puis en dessous, dans la section _certificats_ cochez _Définir un emplacement de fichier du certificat_ -- Dans le champs de saisie, mettez `/swag-ssl/live/mondomaine.fr/fullchain.pem` en remplaçant `mondomaine.fr` par votre domaine principal. +- Dans le champ de saisie, mettez `/swag-ssl/live/mondomaine.fr/fullchain.pem` en remplaçant `mondomaine.fr` par votre domaine principal. - Dans _clé privée_ cochez _Définir un fichier pour la clef privée_ -- Dans le champs de saisie, mettez `/swag-ssl/live/mondomaine.fr/privkey.pem` en remplaçant `mondomaine.fr` par votre domaine principal. +- Dans le champ de saisie, mettez `/swag-ssl/live/mondomaine.fr/privkey.pem` en remplaçant `mondomaine.fr` par votre domaine principal. - Validez Et voilà ! Vous avez protégé vos futures requêtes DNS ! @@ -376,11 +376,11 @@ Et voilà ! Vous avez protégé vos futures requêtes DNS ! ## Configurer les appareils Pour configurer vos appareils, vous avez plusieurs choix (que vous pouvez cumuler). ### Sécuriser le réseau local -Vous pouvez sécuriser votre réseau local avec adguard en configurant votre box pour que chaque requête DNS soit dirigée par défaut vers adguard plutot que les services de votre FAI. Attention, votre box doit pouvoir permettre le changement de DNS (Orange ne le permet pas). +Vous pouvez sécuriser votre réseau local avec adguard en configurant votre box pour que chaque requête DNS soit dirigée par défaut vers adguard plutôt que les services de votre FAI. Attention, votre box doit pouvoir permettre le changement de DNS (Orange ne le permet pas). Généralement cette option est dans les paramètres _DHCP_ de votre box. Pensez bien à ajouter un serveur secondaire tel que : -- Cloudlare : `1.1.1.1` +- Cloudflare : `1.1.1.1` - Google : `8.8.8.8` En effet, sans cela, si votre serveur tombe, vos appareils n'arriveraient plus à se connecter à internet. @@ -393,7 +393,7 @@ Des appareils peuvent avoir un autre DNS paramétré et ne pas utiliser ceux de ### Forcer un navigateur à utiliser Adguard Dans votre navigateur, vous pouvez configurer un DNS pour le forcer à utiliser adguard home. -Dans les paramètres, il vous faudra renseigner l'adresse` https://adguard.mondomaine.fr/dns-query` +Dans les paramètres, il vous faudra renseigner l'adresse `https://adguard.mondomaine.fr/dns-query` ### Windows, paramétrer Adguard au niveau système -- 2.54.0 From 67d593cb73661cdb407a6020aed4845364b0fce5 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 14:35:25 +0200 Subject: [PATCH 17/20] Add Uptime-Kuma introduction, write descriptive alt text site-wide, and fix brand capitalization and filenames with spaces --- content/en/2.general/2.networking/1.nat.md | 2 +- content/en/2.general/2.networking/2.dns.md | 2 +- content/en/2.general/3.storage/1.raid.md | 10 +++--- content/en/2.general/3.storage/2.zfs.md | 2 +- content/en/2.general/4.hardware/1.basics.md | 10 +++--- content/en/2.general/4.hardware/3.prolonas.md | 2 +- content/en/3.serveex/1.introduction.md | 8 ++--- content/en/3.serveex/2.core/1.installation.md | 2 +- content/en/3.serveex/2.core/2.docker.md | 4 +-- content/en/3.serveex/2.core/3.wireguard.md | 10 +++--- content/en/3.serveex/2.core/4.swag.md | 10 +++--- content/en/3.serveex/3.security/3.tinyauth.md | 10 +++--- .../en/3.serveex/3.security/4.pocket-id.md | 6 ++-- .../3.serveex/4.monitoring/1.uptime-kuma.md | 10 +++--- content/en/3.serveex/4.monitoring/2.dozzle.md | 8 ++--- .../4.monitoring/3.speedtest-tracker.md | 2 +- content/en/3.serveex/4.monitoring/4.beszel.md | 14 ++++---- content/en/3.serveex/4.monitoring/5.upsnap.md | 8 ++--- content/en/3.serveex/5.media/1.jellyfin.md | 2 +- content/en/3.serveex/5.media/2.qbittorrent.md | 30 ++++++++--------- content/en/3.serveex/5.media/3.servarr.md | 14 ++++---- content/en/3.serveex/6.cloud/1.immich.md | 2 +- content/en/3.serveex/6.cloud/2.nextcloud.md | 8 ++--- .../7.files/1.file-browser-quantum.md | 8 ++--- content/en/3.serveex/7.files/2.pingvin.md | 18 +++++------ .../3.serveex/8.development/1.code-server.md | 6 ++-- .../en/3.serveex/8.development/2.forgejo.md | 6 ++-- .../en/3.serveex/8.development/3.it-tools.md | 6 ++-- content/en/3.serveex/9.apps/1.adguard.md | 22 ++++++------- .../en/3.serveex/91.advanced/1.authentik.md | 12 +++---- content/en/3.serveex/91.advanced/2.arcane.md | 4 +-- content/en/4.stockeex/1.introduction.md | 2 +- content/en/5.nonsense/1.summary.md | 2 +- .../en/5.nonsense/2.python/2.adguard-cidre.md | 20 ++++++------ .../5.nonsense/3.bash/1.servarr-duplicates.md | 2 +- content/en/5.nonsense/3.bash/3.socat-proxy.md | 2 +- content/en/6.recycled/1.summary.md | 4 +-- .../6.recycled/2.deprecated/1.wireguard-14.md | 14 ++++---- .../6.recycled/2.deprecated/2.file-browser.md | 8 ++--- .../en/6.recycled/3.alternatives/1.plex.md | 6 ++-- ... for plex.md => 2.qbittorrent-for-plex.md} | 30 ++++++++--------- ...varr for plex.md => 3.servarr-for-plex.md} | 12 +++---- .../en/6.recycled/3.alternatives/4.gitea.md | 6 ++-- content/en/index.md | 2 +- content/fr/2.general/2.networking/1.nat.md | 2 +- content/fr/2.general/2.networking/2.dns.md | 2 +- content/fr/2.general/2.networking/3.samba.md | 2 +- content/fr/2.general/3.storage/1.raid.md | 10 +++--- content/fr/2.general/3.storage/2.zfs.md | 4 +-- content/fr/2.general/4.hardware/1.basics.md | 10 +++--- content/fr/2.general/4.hardware/3.prolonas.md | 6 ++-- content/fr/3.serveex/1.introduction.md | 8 ++--- content/fr/3.serveex/2.core/1.installation.md | 2 +- content/fr/3.serveex/2.core/2.docker.md | 4 +-- content/fr/3.serveex/2.core/3.wireguard.md | 12 +++---- content/fr/3.serveex/2.core/4.swag.md | 10 +++--- .../fr/3.serveex/3.security/2.cloudflare.md | 2 +- content/fr/3.serveex/3.security/3.tinyauth.md | 10 +++--- .../fr/3.serveex/3.security/4.pocket-id.md | 6 ++-- .../3.serveex/4.monitoring/1.uptime-kuma.md | 10 +++--- content/fr/3.serveex/4.monitoring/2.dozzle.md | 8 ++--- .../4.monitoring/3.speedtest-tracker.md | 2 +- content/fr/3.serveex/4.monitoring/4.beszel.md | 14 ++++---- content/fr/3.serveex/4.monitoring/5.upsnap.md | 8 ++--- content/fr/3.serveex/5.media/1.jellyfin.md | 2 +- content/fr/3.serveex/5.media/2.qbittorrent.md | 28 ++++++++-------- content/fr/3.serveex/5.media/3.servarr.md | 14 ++++---- content/fr/3.serveex/6.cloud/1.immich.md | 2 +- content/fr/3.serveex/6.cloud/2.nextcloud.md | 8 ++--- .../7.files/1.file-browser-quantum.md | 8 ++--- content/fr/3.serveex/7.files/2.pingvin.md | 18 +++++------ .../3.serveex/8.development/1.code-server.md | 6 ++-- .../fr/3.serveex/8.development/2.forgejo.md | 6 ++-- .../fr/3.serveex/8.development/3.it-tools.md | 6 ++-- content/fr/3.serveex/9.apps/1.adguard.md | 32 +++++++++---------- .../fr/3.serveex/91.advanced/1.authentik.md | 12 +++---- content/fr/3.serveex/91.advanced/2.arcane.md | 4 +-- content/fr/4.stockeex/1.introduction.md | 2 +- content/fr/5.nonsense/1.summary.md | 2 +- .../fr/5.nonsense/2.python/2.adguard-cidre.md | 20 ++++++------ .../5.nonsense/3.bash/1.servarr-duplicates.md | 2 +- content/fr/5.nonsense/3.bash/3.socat-proxy.md | 2 +- content/fr/6.recycled/1.summary.md | 4 +-- .../6.recycled/2.deprecated/1.wireguard-14.md | 16 +++++----- .../6.recycled/2.deprecated/2.file-browser.md | 8 ++--- .../fr/6.recycled/3.alternatives/1.plex.md | 6 ++-- ... for plex.md => 2.qbittorrent-for-plex.md} | 28 ++++++++-------- ...varr for plex.md => 3.servarr-for-plex.md} | 12 +++---- .../fr/6.recycled/3.alternatives/4.gitea.md | 6 ++-- content/fr/index.md | 2 +- 90 files changed, 380 insertions(+), 376 deletions(-) rename content/en/6.recycled/3.alternatives/{2.qbittorrent for plex.md => 2.qbittorrent-for-plex.md} (90%) rename content/en/6.recycled/3.alternatives/{3.servarr for plex.md => 3.servarr-for-plex.md} (97%) rename content/fr/6.recycled/3.alternatives/{2.qbittorrent for plex.md => 2.qbittorrent-for-plex.md} (91%) rename content/fr/6.recycled/3.alternatives/{3.servarr for plex.md => 3.servarr-for-plex.md} (97%) diff --git a/content/en/2.general/2.networking/1.nat.md b/content/en/2.general/2.networking/1.nat.md index 4c50571..debe593 100644 --- a/content/en/2.general/2.networking/1.nat.md +++ b/content/en/2.general/2.networking/1.nat.md @@ -7,7 +7,7 @@ description: Learn how NAT, port forwarding, and DHCP work on a home router. Con :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -![picture](/img/global/nat.svg) +![Diagram of NAT translating a private LAN address to a public IP address](/img/global/nat.svg) ## What is a "port"? diff --git a/content/en/2.general/2.networking/2.dns.md b/content/en/2.general/2.networking/2.dns.md index 2becd81..871ed02 100644 --- a/content/en/2.general/2.networking/2.dns.md +++ b/content/en/2.general/2.networking/2.dns.md @@ -12,7 +12,7 @@ When you browse a website or use an app, requests are made to one or more domain The DNS zone is like a registry with signposts that direct your requests to the correct destination. -![Picture](/img/global/dns.svg) +![Diagram of a DNS zone directing requests to the right server](/img/global/dns.svg) ## The DNS Zone diff --git a/content/en/2.general/3.storage/1.raid.md b/content/en/2.general/3.storage/1.raid.md index ff9bcf9..b7c0620 100644 --- a/content/en/2.general/3.storage/1.raid.md +++ b/content/en/2.general/3.storage/1.raid.md @@ -30,7 +30,7 @@ RAID is not a backup system but a service continuity system! It only allows hot- ### No RAID
- Image + Disks with no RAID redundancy
  • Just your disks, without RAID. Data is stored disk by disk.
  • If you lose a disk, only its data is lost.
    • @@ -43,7 +43,7 @@ Use your disks without RAID when you're not afraid of data loss and can tolerate ### RAID 0
    - Image + RAID 0 striping data across disks
    • OS sees 1 drive.
    • Data is striped across all disks.
      • @@ -59,7 +59,7 @@ Use RAID 0 when you prioritize performance and are not concerned about data loss ### RAID 1
      - Image + RAID 1 mirroring data across disks
      • OS sees 1 drive.
      • All disks contain identical data.
        • @@ -78,7 +78,7 @@ Use RAID 1 for strong redundancy. Each disk contains all data, so performance re ### RAID 5

        - Image + RAID 5 with distributed parity

        - OS sees 1 drive. @@ -92,7 +92,7 @@ Use RAID 5 when you want reliable storage with 3 to 5 disks and minimal space lo ### RAID 6

        - Image + RAID 6 with double distributed parity

        - OS sees 1 drive. diff --git a/content/en/2.general/3.storage/2.zfs.md b/content/en/2.general/3.storage/2.zfs.md index cc35cc0..e121c09 100644 --- a/content/en/2.general/3.storage/2.zfs.md +++ b/content/en/2.general/3.storage/2.zfs.md @@ -24,7 +24,7 @@ Here’s what we’re most interested in: - Its robust error notifications and monitoring. ## Structure -![](/img/global/zfs.svg) +![ZFS logo](/img/global/zfs.svg) ZFS has a unique structure: diff --git a/content/en/2.general/4.hardware/1.basics.md b/content/en/2.general/4.hardware/1.basics.md index 93de99c..02ee50d 100644 --- a/content/en/2.general/4.hardware/1.basics.md +++ b/content/en/2.general/4.hardware/1.basics.md @@ -31,7 +31,7 @@ Larger boards generally offer more ports and features. Pre-built systems might u ## CPU
        - Image + CPU icon

        The CPU (Central Processing Unit) is the computer's calculator. It processes most software tasks. Modern CPUs have multiple cores, often with virtual threads, to better handle workloads. They need to be cooled using either an active cooler (with a fan) or a passive one (fanless), depending on power consumption (watts). Choose your CPU based on how you plan to use the server.

        @@ -51,7 +51,7 @@ For low-power home servers or NAS (non-intensive computing), consider Intel N100 ## RAM

        - Image + RAM icon

        __RAM__ (Random Access Memory) is fast, temporary memory used by the CPU (and iGPU if applicable) for quick access during execution. It clears periodically and when the machine powers down. Better RAM = better CPU performance. @@ -67,7 +67,7 @@ Depending on the required performance, one can choose between a dedicated GPU wi ## HDD(s)

        - Image + Hard disk drive icon

        An __HDD__ (Hard Disk Drive), or hard drive, is a component used to store data. It was once the standard storage device in computers. HDDs consist of one or more stacked platters and read/write heads, somewhat like a vinyl record player. @@ -85,7 +85,7 @@ Comes in 3.5" and 2.5" formats; servers usually favor the more reliable 3.5". ## SSD(s)

        - Image + NVMe SSD icon

        An __SSD__ (Solid State Drive) is a small circuit board with memory chips soldered onto it, used to store information. Unlike RAM, these chips retain data even when not powered, meaning the information is preserved after a reboot. SSDs are generally used as the main storage medium for your server. @@ -144,7 +144,7 @@ To choose the right PSU, a common rule of thumb is to estimate your system’s p ## Case
        - Image + Computer case icon

        The case is also an essential component of your machine. It plays a key role in cooling, through its fans and airflow design, and it determines the form factor compatibility for your motherboard, power supply, and any dedicated GPU you may install.

        diff --git a/content/en/2.general/4.hardware/3.prolonas.md b/content/en/2.general/4.hardware/3.prolonas.md index e1f259d..744e836 100644 --- a/content/en/2.general/4.hardware/3.prolonas.md +++ b/content/en/2.general/4.hardware/3.prolonas.md @@ -20,7 +20,7 @@ A mini PC for $100 + a USB dock for $50 that holds multiple hard drives = a comp That’s all a **ProloNAS** is: a NAS anyone can afford. The name is a French pun, *prolo* (slang for "working-class") plus *NAS*, a home server for the rest of us, not just people who can drop $1000 on a branded box. It’s then up to you to scale your storage capacity according to your needs. -![](/img/global/prolonas.svg) +![Diagram of a mini PC paired with a DAS enclosure forming a ProloNAS](/img/global/prolonas.svg) ## Example Hardware diff --git a/content/en/3.serveex/1.introduction.md b/content/en/3.serveex/1.introduction.md index 16d7d79..e9308c1 100644 --- a/content/en/3.serveex/1.introduction.md +++ b/content/en/3.serveex/1.introduction.md @@ -9,7 +9,7 @@ navigation: :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} ## A Home Lab by a Beginner, for Beginners -![](/img/serveex/serveex-server.svg) +![Diagram of a home server replacing cloud services](/img/serveex/serveex-server.svg) **Serveex** is primarily a personal project aimed at hosting as many everyday services as possible at home, without relying on proprietary platforms (Google, Apple, Netflix, etc.). The goal was to experiment, learn, and document every step along the way. This is purely a scientific project and is not intended for production use. @@ -62,7 +62,7 @@ to: /serveex/core/wireguard ui: icon: text-[#88171A] --- -Install and deploy Wireguard +Install and deploy WireGuard :: ::card{icon="i-noto-globe-showing-americas" title="Reverse Proxy" to="/serveex/core/swag"} @@ -174,7 +174,7 @@ to: /serveex/media/qbittorrent ui: icon: text-[#2F67BA] --- -Install and deploy Qbittorrent +Install and deploy qBittorrent :: ::card @@ -284,7 +284,7 @@ to: /serveex/apps/adguard ui: icon: text-[#68BC71] --- -Install and deploy Adguard Home +Install and deploy AdGuard Home :: ::card diff --git a/content/en/3.serveex/2.core/1.installation.md b/content/en/3.serveex/2.core/1.installation.md index 3eddd07..0d6502a 100644 --- a/content/en/3.serveex/2.core/1.installation.md +++ b/content/en/3.serveex/2.core/1.installation.md @@ -10,7 +10,7 @@ description: Step-by-step guide to install Debian 13 on a home server and set up The other reason is that it stays out of your way. Appliance systems like Unraid, TrueNAS or Synology's DSM put their own layer on top of Linux, and the day you need something their interface doesn't expose, you're stuck working around it. Debian is just a server: you install what you want, where you want, and nothing is hidden behind someone else's UI. It also happens to be what most self-hosted projects target first, so their docs hand you `apt` commands that work as-is, Docker publishes an official Debian repository, and any error message you paste into a search engine already has years of answers behind it. A minimal install is light enough to leave nearly all the RAM and CPU of a small N100 box to your containers. -![picture](/img/serveex/server.svg) +![Server icon](/img/serveex/server.svg) ## Installation diff --git a/content/en/3.serveex/2.core/2.docker.md b/content/en/3.serveex/2.core/2.docker.md index 14042f0..4a7d432 100644 --- a/content/en/3.serveex/2.core/2.docker.md +++ b/content/en/3.serveex/2.core/2.docker.md @@ -12,7 +12,7 @@ A **container** sidesteps the problem: it packages an app together with everythi **Docker** is the tool that builds, starts and manages these containers. Point it at an *image*, a ready-made snapshot of an app maintained by its developers, and it downloads it and runs it in one command. The rest of Serveex is built entirely on it: every app from here on is one Docker container, or a handful of them working together. -![picture](/img/serveex/docker.svg) +![Diagram of Docker containers running isolated from the host system](/img/serveex/docker.svg) ## Install Docker ::steps{level="3"} @@ -53,7 +53,7 @@ sudo mkdir /srv/docker ## Install [Dockge](https://github.com/louislam/dockge) to manage and deploy containers [Dockge](https://github.com/louislam/dockge) is a web tool to create, configure, launch, and manage Docker containers. It's a simple, intuitive interface that’s lighter and easier for beginners than using the CLI or Portainer. -![picture](/img/serveex/dockge.png) +![Dockge web interface for managing Docker Compose stacks](/img/serveex/dockge.png) ### Configuration diff --git a/content/en/3.serveex/2.core/3.wireguard.md b/content/en/3.serveex/2.core/3.wireguard.md index 63f9db0..f71fe0e 100644 --- a/content/en/3.serveex/2.core/3.wireguard.md +++ b/content/en/3.serveex/2.core/3.wireguard.md @@ -1,5 +1,5 @@ --- -title: Wireguard +title: WireGuard description: Install and configure WireGuard VPN to securely access your homelab from anywhere and connect all your devices to your private network. --- @@ -9,10 +9,10 @@ description: Install and configure WireGuard VPN to securely access your homelab ## Introduction Using a VPN allows remote access to a server’s local resources without exposing them to the internet. It’s a clean and secure way to access services like SSH without exposing the port publicly. With a VPN, you can securely connect to your network from anywhere and make devices on different networks communicate. -Here we will use [Wireguard](https://www.wireguard.com/), a secure and high-performance VPN server, using containers: +Here we will use [WireGuard](https://www.wireguard.com/), a secure and high-performance VPN server, using containers: - [wg-easy](https://github.com/wg-easy/wg-easy) as the server, providing a very simple web UI to manage connections and download config files (including QR codes for phones) -- [Wireguard](https://docs.linuxserver.io/images/docker-wireguard/?h=wireguard) as the client for Linux systems +- [WireGuard](https://docs.linuxserver.io/images/docker-wireguard/?h=wireguard) as the client for Linux systems Clients are also available for Windows, macOS, iOS, and Android. @@ -27,7 +27,7 @@ To achieve this, we’ll create a **Virtual Private Network** (VPN), i.e., a sec Additionally, you can add your phone, laptop, or other devices to the VPN and securely access your server resources wherever you are. -![picture](/img/serveex/vpn.svg) +![Diagram of a VPN tunnel connecting a remote device to the home network](/img/serveex/vpn.svg) In this diagram, machine 1 is part of two networks: @@ -276,4 +276,4 @@ Repeat this setup for each client. And here’s the final setup overview: -![picture](/img/serveex/wireguard.svg) +![Diagram of the WireGuard client-server tunnel setup](/img/serveex/wireguard.svg) diff --git a/content/en/3.serveex/2.core/4.swag.md b/content/en/3.serveex/2.core/4.swag.md index c17fd9a..43657f8 100644 --- a/content/en/3.serveex/2.core/4.swag.md +++ b/content/en/3.serveex/2.core/4.swag.md @@ -6,7 +6,7 @@ description: Set up SWAG as a reverse proxy with automatic SSL, expose your serv :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -[Swag](https://docs.linuxserver.io/general/swag/) is the core of this homelab. It’s a powerful reverse proxy that allows you to expose services on the internet using domain names, handling SSL certificate issuance (for encrypted connections), request routing, and access security (via HTTP auth or SSO like Authelia or Authentik). All the necessary documentation is [available here](https://docs.linuxserver.io/general/swag). +[SWAG](https://docs.linuxserver.io/general/swag/) is the core of this homelab. It’s a powerful reverse proxy that allows you to expose services on the internet using domain names, handling SSL certificate issuance (for encrypted connections), request routing, and access security (via HTTP auth or SSO like Authelia or Authentik). All the necessary documentation is [available here](https://docs.linuxserver.io/general/swag). ::warning{to="/serveex/core/wireguard"} @@ -17,7 +17,7 @@ Below is an example exposing Dockge. We will install SWAG along with the dbip mo **Reverse proxy principle and its application in our case:** -![Picture](/img/serveex/reverse-proxy.svg) +![Diagram of a reverse proxy forwarding requests to the right backend service](/img/serveex/reverse-proxy.svg) ## Installation @@ -161,7 +161,7 @@ Save with :kbd{value="Ctrl+O"}, then :kbd{value="Enter"}, and exit with :kbd{val ### Enable DBIP in nginx.conf -Now configure swag to access DBIP, the geolocation-based access control module. Open the `nginx.conf` file: +Now configure SWAG to access DBIP, the geolocation-based access control module. Open the `nginx.conf` file: ```bash [Terminal] sudo nano /srv/docker/swag/config/nginx/nginx.conf @@ -182,7 +182,7 @@ Restart the stack in Dockge. This time, the SSL certificate should be successful Access the dashboard locally by going to `http://yourserverip:81` On the left, you'll see a list of currently "proxied" services (none yet). On the right, the list of banned IPs. Below, various indicators. For more details, [click here](https://www.linuxserver.io/blog/introducing-swag-dashboard). -![picture](/img/serveex/swag-dashboard.png) +![SWAG dashboard showing proxied services and banned IPs](/img/serveex/swag-dashboard.png) ## DBIP DBIP allows you to block connections based on countries. It relies on the configuration file named `dbip.conf` located in `/srv/docker/swag/config/nginx`. [More info here](https://virtualize.link/secure/). @@ -290,7 +290,7 @@ Now it's time to expose Dockge on the internet so you can access and manage your ::warning -Dockge does not support multi-factor authentication. Exposing it online could compromise all connected machines. Only do this if you're using an MFA solution like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, don’t expose it with SWAG. Use a VPN like [Wireguard](/serveex/core/wireguard) instead. +Dockge does not support multi-factor authentication. Exposing it online could compromise all connected machines. Only do this if you're using an MFA solution like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, don’t expose it with SWAG. Use a VPN like [WireGuard](/serveex/core/wireguard) instead. :: ::steps{level="3"} diff --git a/content/en/3.serveex/3.security/3.tinyauth.md b/content/en/3.serveex/3.security/3.tinyauth.md index 2882fc6..89498cb 100644 --- a/content/en/3.serveex/3.security/3.tinyauth.md +++ b/content/en/3.serveex/3.security/3.tinyauth.md @@ -1,12 +1,12 @@ --- title: TinyAuth -description: Install TinyAuth, a lightweight forward-auth proxy, and pair it with Pocket ID to add SSO login in front of your self-hosted apps. Protect your app behind Swag with forward-auth. +description: Install TinyAuth, a lightweight forward-auth proxy, and pair it with Pocket ID to add SSO login in front of your self-hosted apps. Protect your app behind SWAG with forward-auth. --- :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -[TinyAuth](https://tinyauth.app) is a small forward-auth proxy: a single login page that Swag can insert in front of any app before letting a request through, checking whether a visitor is authenticated before forwarding them on. +[TinyAuth](https://tinyauth.app) is a small forward-auth proxy: a single login page that SWAG can insert in front of any app before letting a request through, checking whether a visitor is authenticated before forwarding them on. ![tinyauth](/img/serveex/tinyauth.png) @@ -135,7 +135,7 @@ It re-prompts for the username, password, and current 6-digit code. From now on, that user needs both their password and a valid code from their authenticator app to log in. -## Exposing TinyAuth with Swag +## Exposing TinyAuth with SWAG TinyAuth needs its own subdomain: it's the page users land on before being forwarded to the app they actually want. ::note @@ -174,7 +174,7 @@ Here we assume the TinyAuth network name is `tinyauth_default`. You can check th ### Create the subdomain.conf file -In the Swag folders, create the file `tinyauth.subdomain.conf`: +In the SWAG folders, create the file `tinyauth.subdomain.conf`: ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ Use **File Browser Quantum** to navigate and edit files instead of using terminal commands. @@ -225,7 +225,7 @@ __If it fails:__ check your firewall rules. :: ## Protecting an app via reverse proxy -Swag doesn't ship a ready-made include file for TinyAuth, so we'll add the forward-auth check directly to the app's own `*.subdomain.conf`. We'll use Dockge as an example. +SWAG doesn't ship a ready-made include file for TinyAuth, so we'll add the forward-auth check directly to the app's own `*.subdomain.conf`. We'll use Dockge as an example. ::steps{level="3"} ### Open the app's subdomain.conf file diff --git a/content/en/3.serveex/3.security/4.pocket-id.md b/content/en/3.serveex/3.security/4.pocket-id.md index e730788..ef0b64d 100644 --- a/content/en/3.serveex/3.security/4.pocket-id.md +++ b/content/en/3.serveex/3.security/4.pocket-id.md @@ -96,7 +96,7 @@ TRUST_PROXY=true |----------|-------|---------| | `APP_URL`{lang=properties} | The public URL you'll use to reach Pocket ID (see exposure below) | `https://id.mydomain.com` | | `ENCRYPTION_KEY`{lang=properties} | The key generated above | `Q2pVEqsTNRkJSO9SkJzU3KZ2...` | -| `TRUST_PROXY`{lang=properties} | Required since Pocket ID sits behind Swag | `true` | +| `TRUST_PROXY`{lang=properties} | Required since Pocket ID sits behind SWAG | `true` | Deploy the stack. The local interface is available at `http://yourserverip:1411`. @@ -114,7 +114,7 @@ Pocket ID doesn't use passwords: your first account is created with a **passkey* Passkeys require a secure context: HTTPS, or `localhost`. Registering one from `http://yourserverip:1411` on another machine will be refused by the browser, since that's plain HTTP to a non-`localhost` address. If setup doesn't complete locally, expose Pocket ID first (see below) and finish setup over HTTPS instead. :: -## Exposing Pocket ID with Swag +## Exposing Pocket ID with SWAG Other apps need to reach Pocket ID over HTTPS to complete the OIDC login flow, so it must be exposed even if you only use it from home. ::note @@ -153,7 +153,7 @@ Here we assume the Pocket ID network name is `pocket-id_default`. You can check ### Create the subdomain.conf file -In the Swag folders, create the file `id.subdomain.conf`: +In the SWAG folders, create the file `id.subdomain.conf`: ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ Use **File Browser Quantum** to navigate and edit files instead of using terminal commands. diff --git a/content/en/3.serveex/4.monitoring/1.uptime-kuma.md b/content/en/3.serveex/4.monitoring/1.uptime-kuma.md index 132fb1d..3e62a6e 100644 --- a/content/en/3.serveex/4.monitoring/1.uptime-kuma.md +++ b/content/en/3.serveex/4.monitoring/1.uptime-kuma.md @@ -6,7 +6,9 @@ description: Install Uptime-Kuma to monitor your self-hosted services uptime, se :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -![picture](/img/serveex/uptime_kuma.jpg) +[Uptime-Kuma](https://github.com/louislam/uptime-kuma) is a self-hosted monitoring tool that regularly checks whether your other services and sites are up and reachable, and alerts you the moment one goes down. It can also build a public status page to share your services' health with others. + +![Uptime-Kuma dashboard showing monitored services and their status](/img/serveex/uptime_kuma.jpg) ## Installation @@ -65,7 +67,7 @@ __If it fails:__ check your firewall rules. ### Done! :: -## Expose with Swag +## Expose with SWAG ::note{icon=""} 📋 __Before you begin:__

        @@ -74,13 +76,13 @@ We assume you have the subdomain `stats.mydomain.com` with a `CNAME` pointing to ::warning -Uptime-Kuma does not use multi-factor authentication. Exposing Uptime-Kuma on the internet could compromise the machines it monitors. Only do this if you're using an MFA system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, don’t expose it with SWAG; use a VPN like [Wireguard](/serveex/core/wireguard) instead. +Uptime-Kuma does not use multi-factor authentication. Exposing Uptime-Kuma on the internet could compromise the machines it monitors. Only do this if you're using an MFA system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, don’t expose it with SWAG; use a VPN like [WireGuard](/serveex/core/wireguard) instead. :: ::steps{level="3"} ### Create the subdomain.conf file -In the Swag folders, create the `stats.subdomain.conf` file. +In the SWAG folders, create the `stats.subdomain.conf` file. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip for those who dislike the terminal:__ diff --git a/content/en/3.serveex/4.monitoring/2.dozzle.md b/content/en/3.serveex/4.monitoring/2.dozzle.md index 4754b68..5b2cc91 100644 --- a/content/en/3.serveex/4.monitoring/2.dozzle.md +++ b/content/en/3.serveex/4.monitoring/2.dozzle.md @@ -104,14 +104,14 @@ Deploy the container. Go to `http://yourserverip:9135`. Voilà, your Dozzle web ### Done! :: -## Exposing Dozzle with Swag +## Exposing Dozzle with SWAG ::warning -Dozzle does not use multi-factor authentication. Exposing Dozzle to the internet could compromise the connected machines. Only do this if you use a multi-factor authentication system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, do not expose it with SWAG and instead use a VPN like [Wireguard](/serveex/core/wireguard). +Dozzle does not use multi-factor authentication. Exposing Dozzle to the internet could compromise the connected machines. Only do this if you use a multi-factor authentication system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, do not expose it with SWAG and instead use a VPN like [WireGuard](/serveex/core/wireguard). :: -You may want to access Dozzle remotely and on all your devices. To do so, we’ll expose Dozzle via Swag. +You may want to access Dozzle remotely and on all your devices. To do so, we’ll expose Dozzle via SWAG. ::note{icon=""} 📋 __Before you begin:__ @@ -150,7 +150,7 @@ We assume the Dozzle network name is `dozzle_default`. You can verify the connec ### Create the subdomain.conf file -In the Swag folder, create the `dozzle.subdomain.conf` file. +In the SWAG folder, create the `dozzle.subdomain.conf` file. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ You can use **File Browser Quantum** to browse and edit files instead of using terminal commands. diff --git a/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md b/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md index ac0a37c..7e957b8 100644 --- a/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md +++ b/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md @@ -102,7 +102,7 @@ Now we want to expose Speedtest Tracker to the internet so you can access it rem ::warning -Speedtest Tracker does not use multi-factor authentication. Exposing it on the internet could compromise connected devices. Do so only if you use a multi-factor system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, avoid using SWAG and prefer a VPN like [Wireguard](/serveex/core/wireguard). +Speedtest Tracker does not use multi-factor authentication. Exposing it on the internet could compromise connected devices. Do so only if you use a multi-factor system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, avoid using SWAG and prefer a VPN like [WireGuard](/serveex/core/wireguard). :: ::steps{level="3"} diff --git a/content/en/3.serveex/4.monitoring/4.beszel.md b/content/en/3.serveex/4.monitoring/4.beszel.md index b70f39c..3b5dc47 100644 --- a/content/en/3.serveex/4.monitoring/4.beszel.md +++ b/content/en/3.serveex/4.monitoring/4.beszel.md @@ -182,14 +182,14 @@ Deploy the stack on the remote server. Data will begin flowing into the web UI a __If it fails:__ check your firewall rules. :: -## Expose Beszel with Swag +## Expose Beszel with SWAG ::warning -Beszel does not support multi-factor authentication. Exposing it on the internet could compromise connected machines. Only do this if you're using a system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, do not expose with SWAG. Use a VPN like [Wireguard](/serveex/core/wireguard) instead. +Beszel does not support multi-factor authentication. Exposing it on the internet could compromise connected machines. Only do this if you're using a system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, do not expose with SWAG. Use a VPN like [WireGuard](/serveex/core/wireguard) instead. :: -If you want to access Beszel remotely from all your devices, expose it using Swag. +If you want to access Beszel remotely from all your devices, expose it using SWAG. ::note{icon="" to="/general/networking/nat"} 📋 __Prerequisite:__ @@ -200,7 +200,7 @@ You must have created a DNS subdomain like `beszel.mydomain.com` with a `CNAME` ::steps{level="3"} ### Add Beszel's network to SWAG -In Dockge, edit Swag's compose file and add Beszel’s network: +In Dockge, edit SWAG's compose file and add Beszel’s network: ```yaml [compose.yaml] --- @@ -219,16 +219,16 @@ networks: external: true ``` -Redeploy the stack and wait for Swag to become fully operational. +Redeploy the stack and wait for SWAG to become fully operational. ::note -We assume the network name is `beszel_default`. You can check connectivity by visiting Swag's dashboard at `http://yourserverip:81`. +We assume the network name is `beszel_default`. You can check connectivity by visiting SWAG's dashboard at `http://yourserverip:81`. :: ### Create the subdomain.conf file -In Swag’s config folders, create `beszel.subdomain.conf`. +In SWAG’s config folders, create `beszel.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ Use **File Browser Quantum** to browse and edit files instead of terminal commands. diff --git a/content/en/3.serveex/4.monitoring/5.upsnap.md b/content/en/3.serveex/4.monitoring/5.upsnap.md index c50bed6..d097470 100644 --- a/content/en/3.serveex/4.monitoring/5.upsnap.md +++ b/content/en/3.serveex/4.monitoring/5.upsnap.md @@ -85,14 +85,14 @@ Deploy the container and go to `http://yourserverip:8095`. Just follow the steps __If it fails:__ check your firewall rules. :: -## Exposing UpSnap with Swag +## Exposing UpSnap with SWAG ::warning -UpSnap does not support multi-factor authentication. Exposing it on the internet could compromise connected machines. Do this only if you're using a multi-factor authentication system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, avoid exposing it with SWAG and use a VPN like [Wireguard](/serveex/core/wireguard) instead. +UpSnap does not support multi-factor authentication. Exposing it on the internet could compromise connected machines. Do this only if you're using a multi-factor authentication system like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, avoid exposing it with SWAG and use a VPN like [WireGuard](/serveex/core/wireguard) instead. :: -You may want to access it remotely from all your devices. To do so, we'll expose UpSnap via Swag. +You may want to access it remotely from all your devices. To do so, we'll expose UpSnap via SWAG. ::note{icon=""} 📋 __Beforehand:__ @@ -131,7 +131,7 @@ Here we assume the network name for upsnap is `upsnap_default`. You can check th ### Create the subdomain.conf file -In the Swag folders, create the file `upsnap.subdomain.conf`. +In the SWAG folders, create the file `upsnap.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ You can use **File Browser Quantum** to navigate your files and edit documents instead of using terminal commands. diff --git a/content/en/3.serveex/5.media/1.jellyfin.md b/content/en/3.serveex/5.media/1.jellyfin.md index 07a4a1e..9989124 100644 --- a/content/en/3.serveex/5.media/1.jellyfin.md +++ b/content/en/3.serveex/5.media/1.jellyfin.md @@ -16,7 +16,7 @@ As always, we'll use the [linuxserver.io image](https://docs.linuxserver.io/imag ::note{to="/serveex/core/wireguard"} -Unlike Plex, Jellyfin has no cloud relay: to access your server outside your local network, you must expose it yourself (see below), or use a VPN like **Wireguard**. +Unlike Plex, Jellyfin has no cloud relay: to access your server outside your local network, you must expose it yourself (see below), or use a VPN like **WireGuard**. :: ## Install Jellyfin diff --git a/content/en/3.serveex/5.media/2.qbittorrent.md b/content/en/3.serveex/5.media/2.qbittorrent.md index e98c733..6034f51 100644 --- a/content/en/3.serveex/5.media/2.qbittorrent.md +++ b/content/en/3.serveex/5.media/2.qbittorrent.md @@ -1,24 +1,24 @@ --- -title: Qbittorrent +title: qBittorrent description: Install qBittorrent with Gluetun and ProtonVPN to download torrents securely behind a VPN on your self-hosted server. --- :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -![Picture](/img/serveex/qbit-vue.jpeg) +![VueTorrent web interface showing active torrent downloads](/img/serveex/qbit-vue.jpeg) To safely download your favorite media, we'll build a system using: -- [Qbittorrent](https://github.com/linuxserver/docker-qbittorrent) as the BitTorrent client +- [qBittorrent](https://github.com/linuxserver/docker-qbittorrent) as the BitTorrent client - [Proton VPN Plus](https://protonvpn.com/torrenting), a VPN to secure your traffic. You need a subscription (promos available) to access the BitTorrent protocol. You can also use another VPN as long as it supports BitTorrent. - [Gluetun](https://github.com/qdm12/gluetun) -- [Qbittorrent port update](https://codeberg.org/TechnoSam/qbittorrent-gluetun-port-update) to automatically update the VPN port (which changes regularly). +- [qBittorrent port update](https://codeberg.org/TechnoSam/qbittorrent-gluetun-port-update) to automatically update the VPN port (which changes regularly). - The [VueTorrent](https://github.com/gabe565/linuxserver-mod-vuetorrent) mod for a modern and intuitive UI. Here’s the system we’ll set up: -![Picture](/img/serveex/qbit.svg) +![Diagram of qBittorrent routing its traffic through the Gluetun VPN tunnel](/img/serveex/qbit.svg) ## Configuration @@ -34,7 +34,7 @@ tree: - gluetun/ - compose.yaml - .env - - "media # linked to Jellyfin and Qbittorrent": + - "media # linked to Jellyfin and qBittorrent": - "downloads/ # generic downloads, selected in settings" - "movies/ # used for downloading movies" - "tvseries/ # used for downloading TV shows" @@ -122,7 +122,7 @@ services: ### Configure the download port update -Before editing the `.env` in Dockge, let's configure the download port update. Proton and most VPNs rotate the forwarding port, which must be communicated to Qbittorrent. +Before editing the `.env` in Dockge, let's configure the download port update. Proton and most VPNs rotate the forwarding port, which must be communicated to qBittorrent. We’ve added the mod `ghcr.io/t-anc/gsp-qbittorent-gluetun-sync-port-mod` to the container. @@ -181,8 +181,8 @@ Detailed info: | `UI_PORT` | Port for accessing the web UI | `5695` | | `PR_KEY` | Private key from Proton | `buKsjNHLyzKMM1qYnzOy4s7SHfly` | | `GSP_KEY` | Key you generated for port update | `MnBa47MeVmk7xiv` | -| `ID` | Qbittorrent UI login username | `user` | -| `PW` | Qbittorrent UI password | `password` | +| `ID` | qBittorrent UI login username | `user` | +| `PW` | qBittorrent UI password | `password` | ### Done! :: @@ -217,7 +217,7 @@ Change your username and password in the "webui" settings. ### Done! :: -You're done! In Qbittorrent settings, under "Downloads", set `/media/downloads` as the default folder. +You're done! In qBittorrent settings, under "Downloads", set `/media/downloads` as the default folder. When adding a download, remember to select the proper directory so Jellyfin can sync correctly (`/media/movies` or `/media/tvseries`). You can also automate this with categories and folders. @@ -225,10 +225,10 @@ When adding a download, remember to select the proper directory so Jellyfin can ::warning -Qbittorrent does not support multi-factor authentication. Exposing it to the internet may put your system at risk. Only do this if you use MFA via [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, don’t expose it with SWAG. Use a VPN like [Wireguard](/serveex/core/wireguard) instead. +qBittorrent does not support multi-factor authentication. Exposing it to the internet may put your system at risk. Only do this if you use MFA via [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, don’t expose it with SWAG. Use a VPN like [WireGuard](/serveex/core/wireguard) instead. :: -To start downloads from outside your home, without a VPN, you can expose the Qbittorrent web UI. +To start downloads from outside your home, without a VPN, you can expose the qBittorrent web UI. ::note @@ -334,9 +334,9 @@ Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ct ### Done! :: -Wait a few minutes, then go to `https://seedbox.mydomain.com`. You should land on the Qbittorrent interface. +Wait a few minutes, then go to `https://seedbox.mydomain.com`. You should land on the qBittorrent interface. -## Protecting Qbittorrent with TinyAuth +## Protecting qBittorrent with TinyAuth Add [TinyAuth](/serveex/security/tinyauth)'s forward-auth check directly to `seedbox.subdomain.conf`, the same way as [the TinyAuth guide](/serveex/security/tinyauth#protecting-an-app-via-reverse-proxy): ```nginx [seedbox.subdomain.conf]{26-38,41-42} @@ -418,4 +418,4 @@ The `location /tinyauth` block runs inside SWAG's own container, so SWAG needs t And that’s it! You now have a ready-to-use media center. -![Picture](/img/serveex/seed.svg) +![Diagram of the complete seedbox setup, from qBittorrent to SWAG](/img/serveex/seed.svg) diff --git a/content/en/3.serveex/5.media/3.servarr.md b/content/en/3.serveex/5.media/3.servarr.md index 246207b..c0e222d 100644 --- a/content/en/3.serveex/5.media/3.servarr.md +++ b/content/en/3.serveex/5.media/3.servarr.md @@ -49,7 +49,7 @@ tree: ::warning -__Warning:__ Make sure to follow this file structure carefully, especially the `media` folder. This folder must be mounted **exactly the same way** in both the _Qbittorrent_ compose file (`/your/path/media:/media`) and the _arr_ applications. If not, the _arr_ apps may not recognize the path provided by Qbittorrent and will fail to create _hardlinks_. Without hardlinks, the _arr_ apps will copy the files instead, **doubling the space used** on your storage. +__Warning:__ Make sure to follow this file structure carefully, especially the `media` folder. This folder must be mounted **exactly the same way** in both the _Qbittorrent_ compose file (`/your/path/media:/media`) and the _arr_ applications. If not, the _arr_ apps may not recognize the path provided by qBittorrent and will fail to create _hardlinks_. Without hardlinks, the _arr_ apps will copy the files instead, **doubling the space used** on your storage. :: ::steps{level="3"} @@ -170,7 +170,7 @@ MEDIA_PATH= |----------------|-------------------------------------------------------------------------------------------------|-------------| | `PUID` | Set using your user info (check with `id yourusername`) | `1000` | | `PGID` | Same as above | `1000` | -| `MEDIA_PATH` | Path to your media folder, here: `/media`. It must match the one used by Qbittorrent. | `/media` | +| `MEDIA_PATH` | Path to your media folder, here: `/media`. It must match the one used by qBittorrent. | `/media` | ::note @@ -207,7 +207,7 @@ Create an account and choose *forms login*. ::warning -__Warning:__ If you already have movies in `movies` from Qbittorrent, do not let Radarr add them. Radarr might modify them, which could stop seeding in Qbittorrent. +__Warning:__ If you already have movies in `movies` from qBittorrent, do not let Radarr add them. Radarr might modify them, which could stop seeding in qBittorrent. :: #### Configure Profiles @@ -216,12 +216,12 @@ Go to *Settings > Profiles*. These are your default quality profiles. When you m ![profiles_radarr](/img/serveex/radarr1.png) -#### Add Qbittorrent +#### Add qBittorrent -In *Settings > Download Clients*, add Qbittorrent. +In *Settings > Download Clients*, add qBittorrent. - Use your server IP as *Host* and port `5695` if following this guide. -- Provide your Qbittorrent *Username* and *Password*. +- Provide your qBittorrent *Username* and *Password*. - Click *Test*. - If successful, click *Save*. @@ -389,7 +389,7 @@ It can be useful to expose Seerr if you want to send requests from outside your ::warning -Seerr has no built-in two-factor authentication. Only expose it if you're using a secure authentication solution like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik). Otherwise, don't expose it with SWAG, use a VPN like [Wireguard](/serveex/core/wireguard) instead. +Seerr has no built-in two-factor authentication. Only expose it if you're using a secure authentication solution like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik). Otherwise, don't expose it with SWAG, use a VPN like [WireGuard](/serveex/core/wireguard) instead. :: ::note diff --git a/content/en/3.serveex/6.cloud/1.immich.md b/content/en/3.serveex/6.cloud/1.immich.md index 874184c..2e3fed9 100644 --- a/content/en/3.serveex/6.cloud/1.immich.md +++ b/content/en/3.serveex/6.cloud/1.immich.md @@ -8,7 +8,7 @@ description: Install Immich, a self-hosted alternative to Google Photos and iClo [Immich](https://immich.app/docs/overview/introduction) is a self-hosted photo and video management solution that replaces cloud services like Google Photos or iCloud. It offers powerful features like face recognition and geolocation. -![Picture](/img/serveex/immich.png) +![Immich web interface showing a photo library timeline](/img/serveex/immich.png) ## Installation diff --git a/content/en/3.serveex/6.cloud/2.nextcloud.md b/content/en/3.serveex/6.cloud/2.nextcloud.md index 2daebaa..4359b8f 100644 --- a/content/en/3.serveex/6.cloud/2.nextcloud.md +++ b/content/en/3.serveex/6.cloud/2.nextcloud.md @@ -8,7 +8,7 @@ description: Install Nextcloud to self-host your files, photos, and calendar, a [Nextcloud](https://nextcloud.com/) is a self-hosted solution that allows you to access and synchronize your data across all your devices. It also includes collaboration features, calendar, and more. It’s a great alternative to services like Google Drive, iCloud, or OneDrive. -![Picture](/img/serveex/nextcloud.png) +![Nextcloud web interface showing files and folders](/img/serveex/nextcloud.png) ## Installation ::note{to="https://docs.linuxserver.io/images/docker-nextcloud/"} @@ -84,8 +84,8 @@ Deploy the stack and visit `http://yourserverip:4545` to complete the setup. __If it fails:__ check your firewall rules. :: -## Exposing Nextcloud with Swag -The goal of this setup is to access Nextcloud remotely from all your devices. We’ll use Swag to expose the app. +## Exposing Nextcloud with SWAG +The goal of this setup is to access Nextcloud remotely from all your devices. We’ll use SWAG to expose the app. ::note @@ -155,7 +155,7 @@ Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ct ### Create the subdomain.conf file -In Swag’s folders, create the file `nextcloud.subdomain.conf`: +In SWAG’s folders, create the file `nextcloud.subdomain.conf`: ```bash [Terminal] sudo nano /srv/docker/swag/config/nginx/proxy-confs/nextcloud.subdomain.conf diff --git a/content/en/3.serveex/7.files/1.file-browser-quantum.md b/content/en/3.serveex/7.files/1.file-browser-quantum.md index aa6401a..4692b73 100644 --- a/content/en/3.serveex/7.files/1.file-browser-quantum.md +++ b/content/en/3.serveex/7.files/1.file-browser-quantum.md @@ -104,14 +104,14 @@ Deploy the container and go to `http://yourserverip:8020`. Log in with the defau __If it doesn't work:__ check your firewall rules. :: -## Exposing File Browser Quantum with Swag +## Exposing File Browser Quantum with SWAG ::warning -File Browser Quantum does not support multi-factor authentication. Exposing it publicly could put your systems at risk. Only do this if you're using a secure authentication solution like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, don't expose it with SWAG. Use a VPN like [Wireguard](/serveex/core/wireguard) instead. +File Browser Quantum does not support multi-factor authentication. Exposing it publicly could put your systems at risk. Only do this if you're using a secure authentication solution like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, don't expose it with SWAG. Use a VPN like [WireGuard](/serveex/core/wireguard) instead. :: -You may want to access File Browser Quantum remotely from all your devices. To do that, we'll expose it through Swag. +You may want to access File Browser Quantum remotely from all your devices. To do that, we'll expose it through SWAG. ::note{icon=""} @@ -149,7 +149,7 @@ Restart the stack by clicking "deploy" and wait for SWAG to fully initialize. ### Create the subdomain.conf file -In the Swag folders, create the file `fbq.subdomain.conf`. +In the SWAG folders, create the file `fbq.subdomain.conf`. ```bash [Terminal] sudo nano /srv/docker/swag/config/nginx/proxy-confs/fbq.subdomain.conf diff --git a/content/en/3.serveex/7.files/2.pingvin.md b/content/en/3.serveex/7.files/2.pingvin.md index 184a931..d32e230 100644 --- a/content/en/3.serveex/7.files/2.pingvin.md +++ b/content/en/3.serveex/7.files/2.pingvin.md @@ -8,7 +8,7 @@ description: Install Pingvin Share, a self-hosted file sharing platform to send [Pingvin](https://github.com/stonith404/pingvin-share) is a tool for quickly sharing files, similar to WeTransfer. Its many sharing options (password, expiration time, custom link, etc.) make it the ideal tool for sharing files quickly. Pingvin can also create _upload requests_, i.e. a shareable link you can send to someone so they can upload their files for you to retrieve. -![picture](/img/serveex/pingvin.png) +![Pingvin Share web interface for uploading and sharing files](/img/serveex/pingvin.png) ## Installation @@ -42,7 +42,7 @@ services: ``` ::note -From here on, we assume the network name for Swag is `swag_default`. +From here on, we assume the network name for SWAG is `swag_default`. :: ::tip{icon=""} @@ -74,8 +74,8 @@ Deploy the container and go to `http://yourserverip:3600`. That's it! Your Pingv __If it fails:__ check your firewall rules. :: -## Exposing Pingvin with Swag -The whole point of a solution like this is being able to access it remotely, from all your devices. To do this, we'll expose Pingvin through Swag. +## Exposing Pingvin with SWAG +The whole point of a solution like this is being able to access it remotely, from all your devices. To do this, we'll expose Pingvin through SWAG. ::note{icon=""} 📋 __Prerequisite:__

        @@ -113,7 +113,7 @@ Redeploy the stack by clicking "deploy" and wait for SWAG to be fully up. ### Create the subdomain.conf file -In the Swag folders, create the `pingvin.subdomain.conf` file. +In the SWAG folders, create the `pingvin.subdomain.conf` file. ::tip{icon="" to="/serveex/files/file-browser-quantum"} @@ -224,15 +224,15 @@ In your Authentik admin area, create an OAuth2/OpenID provider. Fill in each section as follows, replacing `mydomain.com` with your own domain. Copy the `Client ID` and `Client Secret` fields somewhere safe. -![picture](/img/serveex/pingvin-auth1.png) -![picture](/img/serveex/pingvin-auth2.png) -![picture](/img/serveex/pingvin-auth3.png) +![Authentik OAuth2/OpenID provider configuration screen, part 1](/img/serveex/pingvin-auth1.png) +![Authentik OAuth2/OpenID provider configuration screen, part 2](/img/serveex/pingvin-auth2.png) +![Authentik OAuth2/OpenID provider configuration screen, part 3](/img/serveex/pingvin-auth3.png) #### Create the application Save and create a `pingvin` application as follows. -![picture](/img/serveex/pingvin-auth4.png) +![Authentik application creation screen for Pingvin Share](/img/serveex/pingvin-auth4.png) #### Add the provider to your outpost diff --git a/content/en/3.serveex/8.development/1.code-server.md b/content/en/3.serveex/8.development/1.code-server.md index 2020ca4..e1bd7b6 100644 --- a/content/en/3.serveex/8.development/1.code-server.md +++ b/content/en/3.serveex/8.development/1.code-server.md @@ -118,8 +118,8 @@ services: ``` Once inside VS Code, you'll have access to the mounted folder. -## Expose code-server with Swag -The whole point of such a solution is to access it remotely from any device. To do this, we’ll expose code-server via Swag. +## Expose code-server with SWAG +The whole point of such a solution is to access it remotely from any device. To do this, we’ll expose code-server via SWAG. ::note @@ -157,7 +157,7 @@ Redeploy the stack by clicking “deploy” and wait until SWAG is fully operati ### Create the subdomain.conf file -Inside the Swag config folders, create the file `code.subdomain.conf`. +Inside the SWAG config folders, create the file `code.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ You can use **File Browser Quantum** to navigate and edit your files instead of using terminal commands. diff --git a/content/en/3.serveex/8.development/2.forgejo.md b/content/en/3.serveex/8.development/2.forgejo.md index 408a645..34e6602 100644 --- a/content/en/3.serveex/8.development/2.forgejo.md +++ b/content/en/3.serveex/8.development/2.forgejo.md @@ -73,8 +73,8 @@ Deploy the container and go to `http://yourserverip:3333`. Your Forgejo instance __If it fails:__ check your firewall rules. :: -## Exposing Forgejo with Swag -The benefit of this setup is being able to access it remotely from any of your devices. To do so, we’ll expose Forgejo through Swag. +## Exposing Forgejo with SWAG +The benefit of this setup is being able to access it remotely from any of your devices. To do so, we’ll expose Forgejo through SWAG. ::note @@ -112,7 +112,7 @@ Redeploy the stack by clicking "Deploy" and wait until SWAG is fully operational ### Create the subdomain.conf file -Inside the Swag folders, create the file `forgejo.subdomain.conf`. +Inside the SWAG folders, create the file `forgejo.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ You can use **File Browser Quantum** to navigate and edit your files instead of using terminal commands. diff --git a/content/en/3.serveex/8.development/3.it-tools.md b/content/en/3.serveex/8.development/3.it-tools.md index 7136a46..88043bc 100644 --- a/content/en/3.serveex/8.development/3.it-tools.md +++ b/content/en/3.serveex/8.development/3.it-tools.md @@ -51,8 +51,8 @@ Deploy the container and visit `http://yourserverip:3222`. That’s it, your IT __If it fails:__ check your firewall rules. :: -## Expose IT Tools with Swag -You might want to access it remotely on all your devices. To do that, we'll expose IT Tools using Swag. +## Expose IT Tools with SWAG +You might want to access it remotely on all your devices. To do that, we'll expose IT Tools using SWAG. ::note @@ -95,7 +95,7 @@ Restart the stack by clicking "deploy" and wait for SWAG to be fully operational ### Create the subdomain.conf file -Inside the Swag folders, create the file `tools.subdomain.conf`. +Inside the SWAG folders, create the file `tools.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ You can use **File Browser Quantum** to navigate and edit your files instead of using terminal commands. diff --git a/content/en/3.serveex/9.apps/1.adguard.md b/content/en/3.serveex/9.apps/1.adguard.md index a920564..4ed3c4f 100644 --- a/content/en/3.serveex/9.apps/1.adguard.md +++ b/content/en/3.serveex/9.apps/1.adguard.md @@ -1,5 +1,5 @@ --- -title: Adguard Home +title: AdGuard Home description: Install AdGuard Home for network-wide ad and tracker blocking with DNS-over-HTTPS, client management, and custom filtering rules. --- @@ -10,9 +10,9 @@ description: Install AdGuard Home for network-wide ad and tracker blocking with It works as a DNS server that redirects tracking domains to a “black hole,” preventing your devices from connecting to them. -In practice, once it's in place, all you need to do is set your devices to use Adguard as their DNS server. +In practice, once it's in place, all you need to do is set your devices to use AdGuard as their DNS server. -![adguard](/img/serveex/adguard.png) +![AdGuard](/img/serveex/adguard.png) **Quick reminder of how DNS works:** @@ -20,14 +20,14 @@ When you visit a site or use an app, it makes requests to various domains to loa By default, your device uses your ISP's DNS server, which is usually configured in your router or, for mobile devices, at the carrier’s CGNAT level. You can change this in your browser settings, your device’s system settings, or even directly in your router, depending on your ISP. -Adguard will act as a middleman between your device and the upstream DNS servers. If you configure your devices to use Adguard: +AdGuard will act as a middleman between your device and the upstream DNS servers. If you configure your devices to use AdGuard: -- If the domain is not in a blocklist, Adguard queries the upstream DNS servers and returns the correct IP to your device. -- If the domain *is* in a blocklist, Adguard will block the request and return nothing, so the associated content won’t load. +- If the domain is not in a blocklist, AdGuard queries the upstream DNS servers and returns the correct IP to your device. +- If the domain *is* in a blocklist, AdGuard will block the request and return nothing, so the associated content won’t load. -This is how ads and malicious domains are blocked: Adguard blocks only the bad domains, allowing the rest of the page to load normally. +This is how ads and malicious domains are blocked: AdGuard blocks only the bad domains, allowing the rest of the page to load normally. -![Picture](/img/serveex/adguard.svg) +![Diagram of AdGuard filtering a DNS request against a blocklist](/img/serveex/adguard.svg) ## Installation @@ -47,7 +47,7 @@ tree: ::note -We will also mount the `/srv/docker/swag/config/etc/letsencrypt` folder to access Swag's SSL certificate. +We will also mount the `/srv/docker/swag/config/etc/letsencrypt` folder to access SWAG's SSL certificate. :: ::steps{level="3"} @@ -102,7 +102,7 @@ The setup wizard asks you to pick an admin interface port. Keep it at `3000`: th ### Done! :: -That’s it! Adguard is deployed. +That’s it! AdGuard is deployed. ## Exposing AdGuard with SWAG To make AdGuard usable from outside your home network, you need to expose it. @@ -363,7 +363,7 @@ To configure encryption: - Go to _Settings_ then _Encryption_. - Set the options as follows: -![Picture](/img/serveex/adguard-chiffrement.png) +![AdGuard Home encryption settings screen](/img/serveex/adguard-chiffrement.png) - Below, in the _Certificates_ section, check _Use file path for certificate_ - In the input field, enter `/swag-ssl/live/mydomain.com/fullchain.pem`, replacing `mydomain.com` with your actual domain. diff --git a/content/en/3.serveex/91.advanced/1.authentik.md b/content/en/3.serveex/91.advanced/1.authentik.md index d7ad2c5..e76a903 100644 --- a/content/en/3.serveex/91.advanced/1.authentik.md +++ b/content/en/3.serveex/91.advanced/1.authentik.md @@ -25,11 +25,11 @@ There are two main modes you should know: - The first allows apps with native support for OpenID-compatible SSO to connect directly to Authentik. This is the preferred method, as the app itself decides what’s public and what’s protected. -![Picture](/img/serveex/auth-native.svg) +![Diagram of an app connecting natively to Authentik via OpenID](/img/serveex/auth-native.svg) - The second method injects Authentik authentication through SWAG before reaching the target service. -![Picture](/img/serveex/auth-proxy.svg) +![Diagram of Authentik injecting authentication through SWAG as a reverse proxy](/img/serveex/auth-proxy.svg) Both modes can be configured on a per-application basis. @@ -374,15 +374,15 @@ Why do this when Dockge already has authentication? Because Dockge uses weak HTT - Select _Applications_ then _Create with wizard_ - Fill in the fields as shown: -![Picture](/img/serveex/auth1.png) +![Authentik application creation wizard](/img/serveex/auth1.png) - At the next step, choose "Forward authentication (single application)" and configure it as shown (flows are important): -![Picture](/img/serveex/auth2.png) +![Authentik forward authentication provider configuration](/img/serveex/auth2.png) - Next, go to the _Outposts_ menu on the left and edit _authentik Embedded Outpost_: -![Picture](/img/serveex/auth3.png) +![Authentik embedded outpost application list](/img/serveex/auth3.png) - Add the `dockge` application by moving it to the right column and save. @@ -414,7 +414,7 @@ Repeat this process for each app you want to protect (unless it has native integ Your new architecture looks like this: -![Picture](/img/serveex/authentik.svg) +![Diagram of the resulting architecture with Authentik protecting apps via SWAG](/img/serveex/authentik.svg) ## Protecting a Remote Server Service For a [native application](/serveex/advanced/authentik/#protecting-a-native-app) (via OAuth 2.0 or other), nothing changes. diff --git a/content/en/3.serveex/91.advanced/2.arcane.md b/content/en/3.serveex/91.advanced/2.arcane.md index 9126cbc..215410b 100644 --- a/content/en/3.serveex/91.advanced/2.arcane.md +++ b/content/en/3.serveex/91.advanced/2.arcane.md @@ -155,7 +155,7 @@ The main benefit of this setup is being able to access Arcane remotely from all ::warning -Arcane's own local login has no multi-factor authentication. Only expose it if you're using [Pocket ID](/serveex/security/pocket-id) (see below) or [Authentik](/serveex/advanced/authentik) for login. Otherwise, don't expose it with SWAG. Use a VPN like [Wireguard](/serveex/core/wireguard) instead, especially given the level of access Arcane has over your host. +Arcane's own local login has no multi-factor authentication. Only expose it if you're using [Pocket ID](/serveex/security/pocket-id) (see below) or [Authentik](/serveex/advanced/authentik) for login. Otherwise, don't expose it with SWAG. Use a VPN like [WireGuard](/serveex/core/wireguard) instead, especially given the level of access Arcane has over your host. :: ::note @@ -194,7 +194,7 @@ Here we assume the Arcane network name is `arcane_default`. You can check the co ### Create the subdomain.conf file -In the Swag folders, create the file `arcane.subdomain.conf`: +In the SWAG folders, create the file `arcane.subdomain.conf`: ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ Use **File Browser Quantum** to navigate and edit files instead of using terminal commands. diff --git a/content/en/4.stockeex/1.introduction.md b/content/en/4.stockeex/1.introduction.md index af3aabf..e70e5ea 100644 --- a/content/en/4.stockeex/1.introduction.md +++ b/content/en/4.stockeex/1.introduction.md @@ -15,5 +15,5 @@ currently writing, come back later... -- ```
        - Image + Diagram of a RAID array
        diff --git a/content/en/5.nonsense/1.summary.md b/content/en/5.nonsense/1.summary.md index 4829d34..95219df 100644 --- a/content/en/5.nonsense/1.summary.md +++ b/content/en/5.nonsense/1.summary.md @@ -32,7 +32,7 @@ Discord alerts for GPU stock availability ::card --- icon: i-cbi-adguard -title: Adguard CIDRE +title: AdGuard CIDRE to: /nonsense/python/adguard-cidre ui: icon: text-[#68BC71] diff --git a/content/en/5.nonsense/2.python/2.adguard-cidre.md b/content/en/5.nonsense/2.python/2.adguard-cidre.md index cbd4817..9a6c83a 100644 --- a/content/en/5.nonsense/2.python/2.adguard-cidre.md +++ b/content/en/5.nonsense/2.python/2.adguard-cidre.md @@ -1,33 +1,33 @@ --- -title: Adguard CIDRE +title: AdGuard CIDRE description: A Python script to sync AdGuard Home CIDR allowlists automatically, securing your self-hosted DNS server exposed to the internet. --- :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -Adguard Home is a fantastic solution for DNS-level ad blocking and rewriting requests, perfect for removing ISP DNS trackers or intrusive ads. +AdGuard Home is a fantastic solution for DNS-level ad blocking and rewriting requests, perfect for removing ISP DNS trackers or intrusive ads. -It works great locally, but if you want all your devices (even on the go) to benefit, you’ll need to expose Adguard to the internet. Unfortunately, that means anyone can use it, potentially overloading your €1/month remote VPS. +It works great locally, but if you want all your devices (even on the go) to benefit, you’ll need to expose AdGuard to the internet. Unfortunately, that means anyone can use it, potentially overloading your €1/month remote VPS. -Adguard allows whitelisting or blacklisting clients. The problem? To whitelist a client, you need their IP, but for mobile phones, that IP changes often. Instead of trying to whitelist ever-changing IPs, the better approach is to block broader IP ranges by region. +AdGuard allows whitelisting or blacklisting clients. The problem? To whitelist a client, you need their IP, but for mobile phones, that IP changes often. Instead of trying to whitelist ever-changing IPs, the better approach is to block broader IP ranges by region. -CIDRE is a tool that syncs geo-targeted IP ranges with firewalls. Instead of running CIDRE with a full firewall stack on the remote server, I figured I could just import those regularly updated IP ranges into Adguard’s blocklist. +CIDRE is a tool that syncs geo-targeted IP ranges with firewalls. Instead of running CIDRE with a full firewall stack on the remote server, I figured I could just import those regularly updated IP ranges into AdGuard’s blocklist. -Thus, Adguard CIDRE Sync was born: a container that syncs Adguard’s blocklist with CIDRE’s updated IP ranges on a schedule of your choosing. +Thus, AdGuard CIDRE Sync was born: a container that syncs AdGuard’s blocklist with CIDRE’s updated IP ranges on a schedule of your choosing. The idea is to: -- Backup Adguard’s config file on first run (original untouched version saved) +- Backup AdGuard’s config file on first run (original untouched version saved) - Download selected country IP ranges via an environment variable - Let you manually add custom IPs via a file - Concatenate, backup the config again (as the updated version), and inject the list into the correct blocklist section -- Reload Adguard by restarting the container (using Docker socket proxy for limited permissions) +- Reload AdGuard by restarting the container (using Docker socket proxy for limited permissions) All fully autonomous, with frequency set via environment variable in the `docker-compose` config. More info directly on the repo: -::card{title="🐋 __Adguard CIDRE Sync__" to="https://git.djeex.fr/Djeex/adguard-cidre" target="_blank"} -Adguard blocklist sync bot +::card{title="🐋 __AdGuard CIDRE Sync__" to="https://git.djeex.fr/Djeex/adguard-cidre" target="_blank"} +AdGuard blocklist sync bot :: diff --git a/content/en/5.nonsense/3.bash/1.servarr-duplicates.md b/content/en/5.nonsense/3.bash/1.servarr-duplicates.md index b9ef2ba..4497ff5 100644 --- a/content/en/5.nonsense/3.bash/1.servarr-duplicates.md +++ b/content/en/5.nonsense/3.bash/1.servarr-duplicates.md @@ -8,7 +8,7 @@ description: A bash script to detect and fix duplicate media files in Sonarr and Six months after downloading terabytes of media, I realized that Sonarr and Radarr were copying them into my Plex library instead of creating hardlinks. This happens due to a counterintuitive mechanism: if you mount multiple folders in Sonarr/Radarr, it sees them as different filesystems and thus cannot create hardlinks. That’s why you should mount only one parent folder containing all child folders (like `downloads`, `movies`, `tvseries` inside a `media` parent folder). -So I restructured my directories, manually updated every path in Qbittorrent, Plex, and others. The last challenge was finding a way to detect existing duplicates, delete them, and automatically create hardlinks instead, to save space. +So I restructured my directories, manually updated every path in qBittorrent, Plex, and others. The last challenge was finding a way to detect existing duplicates, delete them, and automatically create hardlinks instead, to save space. ::file-tree --- diff --git a/content/en/5.nonsense/3.bash/3.socat-proxy.md b/content/en/5.nonsense/3.bash/3.socat-proxy.md index 50432cc..cc64ea1 100644 --- a/content/en/5.nonsense/3.bash/3.socat-proxy.md +++ b/content/en/5.nonsense/3.bash/3.socat-proxy.md @@ -23,7 +23,7 @@ With this setup, Docker Socket Proxy communicates with Socat Proxy in their isol In short: -![](/img/nonsense/socat-proxy.svg) +![Diagram of Socat Proxy relaying the Docker socket between isolated networks](/img/nonsense/socat-proxy.svg) For example, with Beszel, the configuration would look like this: diff --git a/content/en/6.recycled/1.summary.md b/content/en/6.recycled/1.summary.md index eb57d24..356826f 100644 --- a/content/en/6.recycled/1.summary.md +++ b/content/en/6.recycled/1.summary.md @@ -21,7 +21,7 @@ Not every article stays current forever. This section keeps two kinds of leftove ::card --- icon: i-simple-icons-wireguard -title: Wireguard 14 +title: WireGuard 14 to: /recycled/deprecated/wireguard-14 ui: icon: text-[#88171A] @@ -55,7 +55,7 @@ The paid-tier alternative to Jellyfin ::card --- icon: i-cbi-qbittorrent -title: Qbittorrent for Plex +title: qBittorrent for Plex to: /recycled/alternatives/qbittorrent-for-plex ui: icon: text-[#2F67BA] diff --git a/content/en/6.recycled/2.deprecated/1.wireguard-14.md b/content/en/6.recycled/2.deprecated/1.wireguard-14.md index e96e109..be0b58a 100644 --- a/content/en/6.recycled/2.deprecated/1.wireguard-14.md +++ b/content/en/6.recycled/2.deprecated/1.wireguard-14.md @@ -1,5 +1,5 @@ --- -title: Wireguard 14 +title: WireGuard 14 description: Archived guide to installing WireGuard VPN using linuxserver.io's older wireguard image, kept for reference only. --- @@ -14,10 +14,10 @@ wg-easy 15 got a lot more complicated, "not so easy" anymore, arguably. That's e ## Introduction Using a VPN allows remote access to a server’s local resources without exposing them to the internet. It’s a clean and secure way to access services like SSH without exposing the port publicly. With a VPN, you can securely connect to your network from anywhere and make devices on different networks communicate. -Here we will use [Wireguard](https://www.wireguard.com/), a secure and high-performance VPN server, using containers: +Here we will use [WireGuard](https://www.wireguard.com/), a secure and high-performance VPN server, using containers: - [wg-easy](https://github.com/wg-easy/wg-easy) as the server, providing a very simple web UI to manage connections and download config files (including QR codes for phones) -- [Wireguard](https://docs.linuxserver.io/images/docker-wireguard/?h=wireguard) as the client for Linux systems +- [WireGuard](https://docs.linuxserver.io/images/docker-wireguard/?h=wireguard) as the client for Linux systems Clients are also available for Windows, macOS, iOS, and Android. @@ -32,7 +32,7 @@ To achieve this, we’ll create a **Virtual Private Network** (VPN), i.e., a sec Additionally, you can add your phone, laptop, or other devices to the VPN and securely access your server resources wherever you are. -![picture](/img/serveex/vpn.svg) +![Diagram of a VPN tunnel connecting a remote device to the home network](/img/serveex/vpn.svg) In this diagram, machine 1 is part of two networks: @@ -257,8 +257,8 @@ Repeat for each client ## Other Devices -- **Phone:** Install Wireguard and scan the QR code from the web UI (`http://your-server-ip:51821`) -- **PC:** Install the Wireguard client and import the config file +- **Phone:** Install WireGuard and scan the QR code from the web UI (`http://your-server-ip:51821`) +- **PC:** Install the WireGuard client and import the config file ::warning @@ -268,4 +268,4 @@ __Warning:__ If a client device is on the same LAN as the server, edit `wg0.conf And this is the result: -![picture](/img/serveex/wireguard.svg) +![Diagram of the WireGuard client-server tunnel setup](/img/serveex/wireguard.svg) diff --git a/content/en/6.recycled/2.deprecated/2.file-browser.md b/content/en/6.recycled/2.deprecated/2.file-browser.md index 9308c54..ec0c4ec 100644 --- a/content/en/6.recycled/2.deprecated/2.file-browser.md +++ b/content/en/6.recycled/2.deprecated/2.file-browser.md @@ -58,14 +58,14 @@ Deploy the container and go to `http://yourserverip:8010`. That’s it! Your Fil __If it doesn’t work:__ check your firewall rules. :: -## Exposing File Browser with Swag +## Exposing File Browser with SWAG ::warning -File Browser does not support multi-factor authentication. Exposing it publicly could put your systems at risk. Only do this if you’re using a secure authentication solution like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, do not expose it with SWAG. Use a VPN like [Wireguard](/serveex/core/wireguard) instead. +File Browser does not support multi-factor authentication. Exposing it publicly could put your systems at risk. Only do this if you’re using a secure authentication solution like [TinyAuth](/serveex/security/tinyauth) or [Authentik](/serveex/advanced/authentik/). Otherwise, do not expose it with SWAG. Use a VPN like [WireGuard](/serveex/core/wireguard) instead. :: -You may want to access File Browser remotely from all your devices. To do that, we’ll expose it through Swag. +You may want to access File Browser remotely from all your devices. To do that, we’ll expose it through SWAG. ::note @@ -103,7 +103,7 @@ Restart the stack by clicking "deploy" and wait for SWAG to fully initialize. ### Create the subdomain.conf file -In the Swag folders, create the file `files.subdomain.conf`. +In the SWAG folders, create the file `files.subdomain.conf`. ```bash [Terminal] sudo nano /srv/docker/swag/config/nginx/proxy-confs/files.subdomain.conf diff --git a/content/en/6.recycled/3.alternatives/1.plex.md b/content/en/6.recycled/3.alternatives/1.plex.md index b650a22..6722a51 100644 --- a/content/en/6.recycled/3.alternatives/1.plex.md +++ b/content/en/6.recycled/3.alternatives/1.plex.md @@ -15,7 +15,7 @@ This is an alternative to **Jellyfin**, kept here for reference. Plex isn't full With *Plex Pass*, you can also organize and play your music content similar to Spotify, the difference being that it’s your content, hosted and streamed from your server. -![picture](/img/serveex/plex.png) +![Plex web interface showing a media library](/img/serveex/plex.png) We'll also install [Tautulli](https://docs.linuxserver.io/images/docker-tautulli/), a tool that provides detailed stats about Plex. As always, we'll use linuxserver.io images where possible. @@ -150,7 +150,7 @@ Plex offers a range of free movies/shows. After creating your account, I recomme Then go to the _Remote Access_ section and manually select a port (we’ll use `1234`). It's best not to use the default port. -![picture](/img/serveex/plex-port.png) +![Plex Remote Access settings with a manually chosen port](/img/serveex/plex-port.png) - On your router, forward TCP port `1234` to port `32400` for your server’s IP using [NAT rules](/general/networking/nat). - Once done, return to Plex to verify that remote access is functional. @@ -173,7 +173,7 @@ Simply add your media to `/media/movies` and `/media/tvseries` on your server. Y If your media is stored on a network disk (e.g. NAS or external hard drive over the network), refer to the **Samba mount guide** so Plex can access it. :: -## Expose Tautulli with Swag +## Expose Tautulli with SWAG You don’t need to expose Plex, as it's accessible via your Plex account on plex.tv. However, you may want to expose Tautulli so you can view stats from a simple URL when you're not home. diff --git a/content/en/6.recycled/3.alternatives/2.qbittorrent for plex.md b/content/en/6.recycled/3.alternatives/2.qbittorrent-for-plex.md similarity index 90% rename from content/en/6.recycled/3.alternatives/2.qbittorrent for plex.md rename to content/en/6.recycled/3.alternatives/2.qbittorrent-for-plex.md index 80b8e57..bd0e2c5 100644 --- a/content/en/6.recycled/3.alternatives/2.qbittorrent for plex.md +++ b/content/en/6.recycled/3.alternatives/2.qbittorrent-for-plex.md @@ -1,5 +1,5 @@ --- -title: Qbittorrent for Plex +title: qBittorrent for Plex description: Install qBittorrent with Gluetun and ProtonVPN to download torrents securely behind a VPN on your self-hosted server. --- @@ -8,22 +8,22 @@ description: Install qBittorrent with Gluetun and ProtonVPN to download torrents ::note{to="/serveex/media/qbittorrent"} -This is the seedbox setup paired with Plex rather than Jellyfin, kept here for reference. See **Qbittorrent** for the same setup paired with Jellyfin, the recommended alternative since Plex isn't fully self-hosted (its own relay, a required account) and gates features behind a Plex Pass paywall. +This is the seedbox setup paired with Plex rather than Jellyfin, kept here for reference. See **qBittorrent** for the same setup paired with Jellyfin, the recommended alternative since Plex isn't fully self-hosted (its own relay, a required account) and gates features behind a Plex Pass paywall. :: -![Picture](/img/serveex/qbit-vue.jpeg) +![VueTorrent web interface showing active torrent downloads](/img/serveex/qbit-vue.jpeg) To safely download your favorite media, we'll build a system using: -- [Qbittorrent](https://github.com/linuxserver/docker-qbittorrent) as the BitTorrent client +- [qBittorrent](https://github.com/linuxserver/docker-qbittorrent) as the BitTorrent client - [Proton VPN Plus](https://protonvpn.com/torrenting), a VPN to secure your traffic. You need a subscription (promos available) to access the BitTorrent protocol. You can also use another VPN as long as it supports BitTorrent. - [Gluetun](https://github.com/qdm12/gluetun) -- [Qbittorrent port update](https://codeberg.org/TechnoSam/qbittorrent-gluetun-port-update) to automatically update the VPN port (which changes regularly). +- [qBittorrent port update](https://codeberg.org/TechnoSam/qbittorrent-gluetun-port-update) to automatically update the VPN port (which changes regularly). - The [VueTorrent](https://github.com/gabe565/linuxserver-mod-vuetorrent) mod for a modern and intuitive UI. Here’s the system we’ll set up: -![Picture](/img/serveex/qbit.svg) +![Diagram of qBittorrent routing its traffic through the Gluetun VPN tunnel](/img/serveex/qbit.svg) ## Configuration @@ -39,7 +39,7 @@ tree: - gluetun/ - compose.yaml - .env - - "media # linked to Plex and Qbittorrent": + - "media # linked to Plex and qBittorrent": - "downloads/ # generic downloads, selected in settings" - "movies/ # used for downloading movies" - "tvseries/ # used for downloading TV shows" @@ -127,7 +127,7 @@ services: ### Configure the port-forwarding sync -Before editing the `.env` in Dockge, let's configure the download port update. Proton and most VPNs rotate the forwarding port, which must be communicated to Qbittorrent. +Before editing the `.env` in Dockge, let's configure the download port update. Proton and most VPNs rotate the forwarding port, which must be communicated to qBittorrent. We’ve added the mod `ghcr.io/t-anc/gsp-qbittorent-gluetun-sync-port-mod` to the container. @@ -186,8 +186,8 @@ Detailed info: | `UI_PORT` | Port for accessing the web UI | `5695` | | `PR_KEY` | Private key from Proton | `buKsjNHLyzKMM1qYnzOy4s7SHfly` | | `GSP_KEY` | Key you generated for port update | `MnBa47MeVmk7xiv` | -| `ID` | Qbittorrent UI login username | `user` | -| `PW` | Qbittorrent UI password | `password` | +| `ID` | qBittorrent UI login username | `user` | +| `PW` | qBittorrent UI password | `password` | ### Done! :: @@ -218,7 +218,7 @@ Change your username and password in the "webui" settings. ### Done! :: -You're done! In Qbittorrent settings, under "Downloads", set `/media/downloads` as the default folder. +You're done! In qBittorrent settings, under "Downloads", set `/media/downloads` as the default folder. When adding a download, remember to select the proper directory so Plex can sync correctly (`/media/movies` or `/media/tvseries`). You can also automate this with categories and folders. @@ -226,10 +226,10 @@ When adding a download, remember to select the proper directory so Plex can sync ::warning -Qbittorrent does not support multi-factor authentication. Exposing it to the internet may put your system at risk. Only do this if you use MFA via [Authentik](/serveex/advanced/authentik/). Otherwise, don’t expose it with SWAG. Use a VPN like [Wireguard](/serveex/core/wireguard) instead. +qBittorrent does not support multi-factor authentication. Exposing it to the internet may put your system at risk. Only do this if you use MFA via [Authentik](/serveex/advanced/authentik/). Otherwise, don’t expose it with SWAG. Use a VPN like [WireGuard](/serveex/core/wireguard) instead. :: -To start downloads from outside your home, without a VPN, you can expose the Qbittorrent web UI. +To start downloads from outside your home, without a VPN, you can expose the qBittorrent web UI. ::note @@ -339,8 +339,8 @@ Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ct ### Done! :: -Wait a few minutes, then go to `https://seedbox.mydomain.com`. You should land on the Qbittorrent interface. +Wait a few minutes, then go to `https://seedbox.mydomain.com`. You should land on the qBittorrent interface. And that’s it! You now have a ready-to-use media center. -![Picture](/img/serveex/seed.svg) +![Diagram of the complete seedbox setup, from qBittorrent to SWAG](/img/serveex/seed.svg) diff --git a/content/en/6.recycled/3.alternatives/3.servarr for plex.md b/content/en/6.recycled/3.alternatives/3.servarr-for-plex.md similarity index 97% rename from content/en/6.recycled/3.alternatives/3.servarr for plex.md rename to content/en/6.recycled/3.alternatives/3.servarr-for-plex.md index cdb17f5..0afb63a 100644 --- a/content/en/6.recycled/3.alternatives/3.servarr for plex.md +++ b/content/en/6.recycled/3.alternatives/3.servarr-for-plex.md @@ -57,7 +57,7 @@ tree: ::warning __Warning:__ Make sure to follow this file structure carefully, especially the `media` folder. This folder must be mounted **exactly the same way** in both the _Qbittorrent_ compose file (`/your/path/media:/media`) and the _arr_ applications. -If not, the _arr_ apps may not recognize the path provided by Qbittorrent and will fail to create _hardlinks_. +If not, the _arr_ apps may not recognize the path provided by qBittorrent and will fail to create _hardlinks_. Without hardlinks, the _arr_ apps will copy the files instead, **doubling the space used** on your storage. :: @@ -205,7 +205,7 @@ MEDIA_PATH= |----------------|-------------------------------------------------------------------------------------------------|-------------| | `PUID` | Set using your user info (check with `id yourusername`) | `1000` | | `PGID` | Same as above | `1000` | -| `MEDIA_PATH` | Path to your media folder, here: `/media`. It must match the one used by Qbittorrent. | `/media` | +| `MEDIA_PATH` | Path to your media folder, here: `/media`. It must match the one used by qBittorrent. | `/media` | Deploy the stack. @@ -233,7 +233,7 @@ Create an account and choose *forms login*. ::warning -__Warning:__ If you already have movies in `movies` from Qbittorrent, do not let Radarr add them. Radarr might modify them, which could stop seeding in Qbittorrent. +__Warning:__ If you already have movies in `movies` from qBittorrent, do not let Radarr add them. Radarr might modify them, which could stop seeding in qBittorrent. :: #### Configure Profiles @@ -242,12 +242,12 @@ Go to *Settings > Profiles*. These are your default quality profiles. When you m ![profiles_radarr](/img/serveex/radarr1.png) -#### Add Qbittorrent +#### Add qBittorrent -In *Settings > Download Clients*, add Qbittorrent. +In *Settings > Download Clients*, add qBittorrent. - Use your server IP as *Host* and port `5695` if following this guide. -- Provide your Qbittorrent *Username* and *Password*. +- Provide your qBittorrent *Username* and *Password*. - Click *Test*. - If successful, click *Save*. diff --git a/content/en/6.recycled/3.alternatives/4.gitea.md b/content/en/6.recycled/3.alternatives/4.gitea.md index 186f55b..23e0820 100644 --- a/content/en/6.recycled/3.alternatives/4.gitea.md +++ b/content/en/6.recycled/3.alternatives/4.gitea.md @@ -75,8 +75,8 @@ Deploy the container and go to `http://yourserverip:3333`. Your Gitea instance i __If it fails:__ check your firewall rules. :: -## Exposing Gitea with Swag -The benefit of this setup is being able to access it remotely from any of your devices. To do so, we’ll expose Gitea through Swag. +## Exposing Gitea with SWAG +The benefit of this setup is being able to access it remotely from any of your devices. To do so, we’ll expose Gitea through SWAG. ::note @@ -114,7 +114,7 @@ Redeploy the stack by clicking "Deploy" and wait until SWAG is fully operational ### Create the subdomain.conf file -Inside the Swag folders, create the file `gitea.subdomain.conf`. +Inside the SWAG folders, create the file `gitea.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Tip:__ You can use **File Browser** to navigate and edit your files instead of using terminal commands. diff --git a/content/en/index.md b/content/en/index.md index 91a5dba..9c6ae18 100644 --- a/content/en/index.md +++ b/content/en/index.md @@ -17,7 +17,7 @@ seo: ::::: :::::div{class="my-6 pt-[25px] pb-[25px]"} -![](/img/global/docudjeex-home.svg){.w-full} +![Docudjeex homepage illustration](/img/global/docudjeex-home.svg){.w-full} ::::: :::::div{class="flex flex-col sm:flex-row sm:items-center gap-3"} diff --git a/content/fr/2.general/2.networking/1.nat.md b/content/fr/2.general/2.networking/1.nat.md index faaf866..dc4f488 100644 --- a/content/fr/2.general/2.networking/1.nat.md +++ b/content/fr/2.general/2.networking/1.nat.md @@ -7,7 +7,7 @@ description: Comprendre le NAT, la redirection de ports et le DHCP sur un routeu :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -![picture](/img/global/nat.svg) +![Schéma du NAT traduisant une adresse LAN privée en adresse IP publique](/img/global/nat.svg) ## Qu'est-ce qu'un « port » ? diff --git a/content/fr/2.general/2.networking/2.dns.md b/content/fr/2.general/2.networking/2.dns.md index b019872..655375a 100644 --- a/content/fr/2.general/2.networking/2.dns.md +++ b/content/fr/2.general/2.networking/2.dns.md @@ -12,7 +12,7 @@ Lorsque vous naviguez sur un site, ou une application, des requêtes sont émise La zone DNS, c'est une sorte de registre avec des panneaux qui redirige vos requêtes vers la bonne destination. -![Picture](/img/global/dns.svg) +![Schéma d'une zone DNS dirigeant les requêtes vers le bon serveur](/img/global/dns.svg) ## La zone DNS diff --git a/content/fr/2.general/2.networking/3.samba.md b/content/fr/2.general/2.networking/3.samba.md index 92109dc..71e0e48 100644 --- a/content/fr/2.general/2.networking/3.samba.md +++ b/content/fr/2.general/2.networking/3.samba.md @@ -8,7 +8,7 @@ description: Configurer Samba sur Debian pour partager des dossiers sur votre r Samba est une implémentation libre du protocole SMB/CIFS, permettant d'accèder à un dossier situé sur un disque réseau. Il peut être configuré sous Mac, Windows ou Linux. -De nombreux tutorials existent pour configurer Samba sous windows ou sur un NAS type Synology, ici nous nous concentrons sur Debian. +De nombreux tutoriels existent pour configurer Samba sous Windows ou sur un NAS type Synology, ici nous nous concentrons sur Debian. ![samba](/img/global/smb.svg) diff --git a/content/fr/2.general/3.storage/1.raid.md b/content/fr/2.general/3.storage/1.raid.md index 87274d5..4dbb1be 100644 --- a/content/fr/2.general/3.storage/1.raid.md +++ b/content/fr/2.general/3.storage/1.raid.md @@ -30,7 +30,7 @@ Il existe plusieurs types de RAID, chacun ayant ses avantages et inconvénients. ### Sans RAID
        - Image + Disques sans redondance RAID
        • Vos disques sans RAID. Les données sont stockées disque par disque.
        • Si vous perdez un disque, seules ses données sont perdues.
          • @@ -43,7 +43,7 @@ Utilisez vos disques sans RAID si vous n’avez pas peur de perdre des données ### RAID 0
          - Image + RAID 0 répartissant les données entre les disques
          • Le système voit un seul disque.
          • Les données sont entrelacées entre tous les disques.
            • @@ -59,7 +59,7 @@ Utilisez RAID 0 si vous souhaitez privilégier la performance et que la perte de ### RAID 1
            - Image + RAID 1 dupliquant les données entre les disques
            • Le système voit un seul disque.
            • Tous les disques contiennent les mêmes données.
              • @@ -78,7 +78,7 @@ Utilisez RAID 1 pour une redondance maximale. Chaque disque contient toutes les ### RAID 5

              - Image + RAID 5 avec parité distribuée

              - Le système voit un seul disque. @@ -92,7 +92,7 @@ Utilisez RAID 5 pour un stockage fiable avec 3 à 5 disques et une perte minimal ### RAID 6

              - Image + RAID 6 avec double parité distribuée

              - Le système voit un seul disque. diff --git a/content/fr/2.general/3.storage/2.zfs.md b/content/fr/2.general/3.storage/2.zfs.md index 1766d84..33d5b3d 100644 --- a/content/fr/2.general/3.storage/2.zfs.md +++ b/content/fr/2.general/3.storage/2.zfs.md @@ -7,7 +7,7 @@ description: Introduction à ZFS, système de fichiers et gestionnaire de volume :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -ZFS est populaire dans le monde des serveurs, des NAS (comme FreeNAS / TrueNAS), de la virtualisation, et même chez les particuliers qui veulent un stockage résilient. C'est un _système de fichier_ (à l'instar de NTFS pour windows, EXT4, FAT32 etc...) mais également un _gestionnaire de volume_ (comme LVM par exemple). +ZFS est populaire dans le monde des serveurs, des NAS (comme FreeNAS / TrueNAS), de la virtualisation, et même chez les particuliers qui veulent un stockage résilient. C'est un _système de fichier_ (à l'instar de NTFS pour Windows, EXT4, FAT32 etc.) mais également un _gestionnaire de volume_ (comme LVM par exemple). Pour le dire simplement : @@ -24,7 +24,7 @@ Ce qui nous intéresse le plus : - ses notifications en cas d'erreur ## Structure -![](/img/global/zfs.svg) +![ZFS logo](/img/global/zfs.svg) ZFS dispose d'une structure particulière : diff --git a/content/fr/2.general/4.hardware/1.basics.md b/content/fr/2.general/4.hardware/1.basics.md index bc7bb81..e966e3c 100644 --- a/content/fr/2.general/4.hardware/1.basics.md +++ b/content/fr/2.general/4.hardware/1.basics.md @@ -31,7 +31,7 @@ Bien sûr, selon la taille, le nombre de ports et de fonctionnalité diffère. D ## Le CPU
              - Image + Icône de CPU

              Le CPU (Central Processing Unit) est la supercalculette de l’ordinateur. Il traite la plupart des tâches logicielles. Aujourd’hui les processeurs comportent plusieurs cœurs, parfois eux-mêmes divisés en deux de façon logicielle, afin de mieux répartir la charge de travail et optimiser son fonctionnement. Il nécessite d'être refroidi avec un dissipateur actif (avec ventilateur) ou passif (sans ventilateur) selon la chaleur qu'il dégage, et donc selon la puissance en Watt qu'il requiert. Dans le cadre d'un serveur, on veillera donc à le choisir selon les usages que l'on aura.

              @@ -51,7 +51,7 @@ Dans le cadre d'un homelab/NAS sans calcul intensif, aujourd'hui on se dirigera ## La RAM

              - Image + Icône de RAM

              La __RAM__ (Random Access Memory), est une zone de stockage éphémère ultra rapide utilisée par le CPU (et l'iGPU le cas échéant) pour stocker des informations et calculs le temps de les exécuter. Elle se vide régulièrement selon les sollicitations et se vide également à chaque extinction de la machine. Plus elle est performante, plus les calculs du processeur sont efficaces. @@ -67,7 +67,7 @@ Selon la puissance requise, on choisira un GPU dédié avec sa propre VRAM (une ## Le ou les HDD

              - Image + Icône de disque dur

              Un __HDD__ (Hard Disk Drive) ou disque dur, est un composant servant à stocker des données. Autrefois, c'était le stockage standard des machines informatiques. Ils sont constitués d'un ou plusieurs disques superposés en plateau, et de têtes de lecture, presque comme une platine vinyle. @@ -85,7 +85,7 @@ Il existe plusieurs formats de HDD : 3.5" et 2.5". De manière générale dans u ## Le ou les SSD

              - Image + Icône de SSD NVMe

              Un __SSD__ (Solid State Drive) est une petite carte sur laquelle sont soudées des puces de mémoires servant à stocker de l'information. Contrairement à la RAM, ces puces conservent les informations même lorsqu'elles ne sont pas alimentées et donc les conservent après un redémarrage. C'est ce qui sert globalement de stockage principal pour votre serveur. @@ -144,7 +144,7 @@ Pour choisir votre alimentation, la convention est d'estimer la puissance élect ## Le boîtier
              - Image + Icône de boîtier

              Le boîtier est également un composant essentiel pour votre machine. Il joue un rôle clé dans le refroidissement, avec ses ventilateurs et sa conception des flux d'air, et il détermine la compatibilité de format de votre carte mère, de votre alimentation et de l'éventuel GPU dédié que vous installerez.

              diff --git a/content/fr/2.general/4.hardware/3.prolonas.md b/content/fr/2.general/4.hardware/3.prolonas.md index d0593e6..111d637 100644 --- a/content/fr/2.general/4.hardware/3.prolonas.md +++ b/content/fr/2.general/4.hardware/3.prolonas.md @@ -12,7 +12,7 @@ Cet article a été écrit avant l'augmentation __massive__ des prix du matérie Lorsque l'on se lance dans l'aventure de son serveur chez soi, on se pose souvent la question _« Avec quoi dois-je commencer ? »_, _« Cela coûte cher non ? »_, et on finit soit par ne pas le faire, soit par acheter un NAS propriétaire qu'on jettera à la poubelle au bout d'un an quand on aura compris que cela n'apporte rien à part des problèmes et de l'argent jeté par la fenêtre. -Un serveur, ce n'est pas une armoire. C'est n'importe quel ordinateur capable de faire tourner linux. C'est pour cela que les mini PC à base de processeurs N100 sont populaires. Pour 100-130€ sur des plateformes chinoises on a une machine sous linux capable de tourner H24 des années durant, et d'exécuter tout ce qu'on attend d'un serveur/cloud chez soi sans perdre en performances. +Un serveur, ce n'est pas une armoire. C'est n'importe quel ordinateur capable de faire tourner Linux. C'est pour cela que les mini PC à base de processeurs N100 sont populaires. Pour 100-130€ sur des plateformes chinoises on a une machine sous linux capable de tourner H24 des années durant, et d'exécuter tout ce qu'on attend d'un serveur/cloud chez soi sans perdre en performances. Ce n'est objectivement pas cher et n'importe qui s'intéressant au sujet peut se lancer dans l'aventure. @@ -20,7 +20,7 @@ Un Mini PC à 100 balles + un dock USB à 50 balles accueillant des disques durs C'est tout simplement ça le **ProloNAS, un NAS accessible pour les prolo**. Charge à vous ensuite de calibrer votre besoin en Disques Durs. -![](/img/global/prolonas.svg) +![Schéma d'un mini PC associé à un boîtier DAS formant un ProloNAS](/img/global/prolonas.svg) ## Exemple de matériel @@ -59,7 +59,7 @@ Rappelez vous le **ProloNAS** : un N100 4 cœurs, 16Go de RAM, un SSD de 512Go, Une année. Une année c'est le temps qu'il m'a fallu pour jeter à la poubelle mon Syno en me disant que j'aurais dû dès le départ partir sur mon **ProloNAS** (devenu un vrai serveur, depuis). -Les constructeurs vous mettent à disposition des OS linux customisés à leur sauce, ne partageant pas les catalogues d'applications linux des distributions majeures, avec des noyaux linux datant souvent de l'antiquité, et surtout des OS très fermés ne vous permettant pas de développer votre NAS exactement selon vos besoins. En gros, soit vous utilisez leurs applications, soit vous rentrez dans un monde de souffrance. Pour donner un exemple, de nombreux conteneurs docker ne fonctionnent pas sur ces NAS constructeurs car le kernel est tellement vieux qu'il ne peut supporter les versions pourtant pas toujours récentes de docker. +Les constructeurs vous mettent à disposition des OS Linux customisés à leur sauce, ne partageant pas les catalogues d'applications Linux des distributions majeures, avec des noyaux linux datant souvent de l'antiquité, et surtout des OS très fermés ne vous permettant pas de développer votre NAS exactement selon vos besoins. En gros, soit vous utilisez leurs applications, soit vous rentrez dans un monde de souffrance. Pour donner un exemple, de nombreux conteneurs docker ne fonctionnent pas sur ces NAS constructeurs car le kernel est tellement vieux qu'il ne peut supporter les versions pourtant pas toujours récentes de docker. ### Dépendance des mises à jour propriétaires diff --git a/content/fr/3.serveex/1.introduction.md b/content/fr/3.serveex/1.introduction.md index af372a2..f85568a 100644 --- a/content/fr/3.serveex/1.introduction.md +++ b/content/fr/3.serveex/1.introduction.md @@ -9,7 +9,7 @@ navigation: :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} ## Un homelab de débutant, pour les débutants -![](/img/serveex/serveex-server.svg) +![Schéma d'un serveur maison remplaçant les services cloud](/img/serveex/serveex-server.svg) **Serveex** est avant tout un projet personnel visant à héberger chez soi le plus de services du quotidien possible, sans dépendre de plateformes propriétaires (Google, Apple, Netflix, etc.). L'objectif était d'expérimenter, d'apprendre, et de documenter chaque étape du chemin. C'est un projet purement scientifique, pas destiné à un usage en production. @@ -62,7 +62,7 @@ to: /serveex/core/wireguard ui: icon: text-[#88171A] --- -Installer et déployer Wireguard +Installer et déployer WireGuard :: ::card{icon="i-noto-globe-showing-americas" title="Reverse Proxy" to="/serveex/core/swag"} @@ -174,7 +174,7 @@ to: /serveex/media/qbittorrent ui: icon: text-[#2F67BA] --- -Installer et déployer Qbittorrent +Installer et déployer qBittorrent :: ::card @@ -284,7 +284,7 @@ to: /serveex/apps/adguard ui: icon: text-[#68BC71] --- -Installer et déployer Adguard Home +Installer et déployer AdGuard Home :: ::card diff --git a/content/fr/3.serveex/2.core/1.installation.md b/content/fr/3.serveex/2.core/1.installation.md index fd0495c..853a2f5 100644 --- a/content/fr/3.serveex/2.core/1.installation.md +++ b/content/fr/3.serveex/2.core/1.installation.md @@ -10,7 +10,7 @@ description: Guide pas à pas pour installer Debian 13 sur un serveur maison et L'autre raison, c'est qu'il ne vous donnera aucune limite, il ne vous enfermera jamais. Les systèmes clés en main comme Unraid, TrueNAS ou le DSM de Synology posent leur propre couche par-dessus, et le jour où vous avez besoin de quelque chose que leur interface n'expose pas, vous serez coincé ou devrez bricoler autour. Debian n'est qu'un serveur : vous installez ce que vous voulez, où vous voulez, et rien n'est caché derrière l'interface de quelqu'un d'autre. C'est exactement ce que la plupart des projets auto-hébergés visent en premier, leurs docs vous donnent donc des commandes `apt` qui fonctionnent telles quelles, et n'importe quel message d'erreur collé dans un moteur de recherche a déjà des années de réponses derrière lui. Une installation minimale est assez légère pour laisser la quasi intégralité de la RAM et du CPU à tous les délires que vous installerez dessus. -![picture](/img/serveex/server.svg) +![Icône de serveur](/img/serveex/server.svg) ## Installation diff --git a/content/fr/3.serveex/2.core/2.docker.md b/content/fr/3.serveex/2.core/2.docker.md index 4a23736..73bc234 100644 --- a/content/fr/3.serveex/2.core/2.docker.md +++ b/content/fr/3.serveex/2.core/2.docker.md @@ -12,7 +12,7 @@ Un **conteneur** contourne le problème : il empaquette une application avec tou **Docker** est l'outil qui construit, démarre et gère ces conteneurs. Pointez-le sur une *image*, un instantané prêt à l'emploi d'une application maintenu par ses développeurs, et il la télécharge et la lance en une commande. Tout le reste de Serveex est bâti dessus : chaque application à partir d'ici est un conteneur Docker, ou une poignée de conteneurs qui travaillent ensemble. -![picture](/img/serveex/docker.svg) +![Schéma de conteneurs Docker isolés du système hôte](/img/serveex/docker.svg) ## Installer Docker ::steps{level="3"} @@ -53,7 +53,7 @@ sudo mkdir /srv/docker ## Installer [Dockge](https://github.com/louislam/dockge) pour gérer et déployer les conteneurs [Dockge](https://github.com/louislam/dockge) est un outil web permettant de créer, configurer, lancer et gérer des conteneurs pour Docker. C'est une interface simple, intuitive, qui est plus légère et plus facile pour les débutants que d'utiliser docker en CLI ou Portainer. -![picture](/img/serveex/dockge.png) +![Interface web de Dockge pour gérer les stacks Docker Compose](/img/serveex/dockge.png) ### Configuration diff --git a/content/fr/3.serveex/2.core/3.wireguard.md b/content/fr/3.serveex/2.core/3.wireguard.md index d11dd05..0d89455 100644 --- a/content/fr/3.serveex/2.core/3.wireguard.md +++ b/content/fr/3.serveex/2.core/3.wireguard.md @@ -1,5 +1,5 @@ --- -title: Wireguard +title: WireGuard description: Installer et configurer WireGuard VPN pour accéder à votre homelab de n'importe où et connecter tous vos appareils à votre réseau privé. --- @@ -9,12 +9,12 @@ description: Installer et configurer WireGuard VPN pour accéder à votre homela ## Introduction L'utilisation d'un VPN permet d'accéder à distance aux ressources locales du serveur sans les exposer sur internet. C'est notamment une manière propre de sécuriser l'accès à la console SSH, plutôt que d'exposer le port sur internet. C'est pouvoir se connecter à son réseau où que l'on soit, de manière sécurisée, et de faire dialoguer des machines qui sont sur des réseaux différents. -Ici nous utiliserons [Wireguard](https://www.wireguard.com/), un serveur VPN sécurisé et très performant, à l'aide des conteneurs : +Ici nous utiliserons [WireGuard](https://www.wireguard.com/), un serveur VPN sécurisé et très performant, à l'aide des conteneurs : - [wg-easy](https://github.com/wg-easy/wg-easy) pour le serveur, qui propose une interface web très simple pour contrôler les connexions et télécharger les fichiers de conf (notamment par QR code pour les téléphones) -- [Wireguard](https://docs.linuxserver.io/images/docker-wireguard/?h=wireguard) pour les clients linux +- [WireGuard](https://docs.linuxserver.io/images/docker-wireguard/?h=wireguard) pour les clients Linux -Il existe aussi des clients Windows, MacOS, iOS et Android. +Il existe aussi des clients Windows, macOS, iOS et Android. Le principe est le suivant : @@ -27,7 +27,7 @@ Pour cela nous allons créer un **réseau privé virtuel**, ou VPN, c'est-à-dir D'autre part, vous pourrez ajouter votre téléphone, un ordinateur portable ou n'importe quel appareil au réseau pour pouvoir utiliser vos ressources depuis vos appareils quotidiens, où que vous soyez. -![picture](/img/serveex/vpn.svg) +![Schéma d'un tunnel VPN reliant un appareil distant au réseau domestique](/img/serveex/vpn.svg) Dans cette illustration, la machine 1 est sur deux réseaux : @@ -276,4 +276,4 @@ Répétez cette installation pour chaque client. Et voici le schéma final de l'installation : -![picture](/img/serveex/wireguard.svg) +![Schéma du tunnel client-serveur WireGuard](/img/serveex/wireguard.svg) diff --git a/content/fr/3.serveex/2.core/4.swag.md b/content/fr/3.serveex/2.core/4.swag.md index 760b674..b40e092 100644 --- a/content/fr/3.serveex/2.core/4.swag.md +++ b/content/fr/3.serveex/2.core/4.swag.md @@ -6,7 +6,7 @@ description: Configurer SWAG comme reverse proxy avec SSL automatique, exposer v :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -[Swag](https://docs.linuxserver.io/general/swag/) est le noyau de ce homelab. C'est un reverse proxy puissant qui permet d'exposer des services sur internet via des noms de domaine, en se chargeant de l'émission des certificats SSL (pour garder des connexions chiffrées), du routage des requêtes et de la sécurisation des accès (par authentification HTTP ou par SSO comme Authelia ou Authentik). Toute la documentation nécessaire est [disponible ici](https://docs.linuxserver.io/general/swag). +[SWAG](https://docs.linuxserver.io/general/swag/) est le noyau de ce homelab. C'est un reverse proxy puissant qui permet d'exposer des services sur internet via des noms de domaine, en se chargeant de l'émission des certificats SSL (pour garder des connexions chiffrées), du routage des requêtes et de la sécurisation des accès (par authentification HTTP ou par SSO comme Authelia ou Authentik). Toute la documentation nécessaire est [disponible ici](https://docs.linuxserver.io/general/swag). ::warning{to="/serveex/core/wireguard"} @@ -17,7 +17,7 @@ Ci-dessous, un exemple exposant Dockge. Nous installerons SWAG ainsi que le mod **Principe d'un reverse proxy et application dans notre cas :** -![Picture](/img/serveex/reverse-proxy.svg) +![Schéma d'un reverse proxy redirigeant les requêtes vers le bon service](/img/serveex/reverse-proxy.svg) ## Installation @@ -161,7 +161,7 @@ Enregistrez avec :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"}, et quittez avec ### Activer DBIP dans nginx.conf -Configurons maintenant swag pour accéder à DBIP, le module de contrôle d'accès par géolocalisation. Ouvrez le fichier `nginx.conf` : +Configurons maintenant SWAG pour accéder à DBIP, le module de contrôle d'accès par géolocalisation. Ouvrez le fichier `nginx.conf` : ```bash [Terminal] sudo nano /srv/docker/swag/config/nginx/nginx.conf @@ -182,7 +182,7 @@ Redémarrez la stack dans Dockge. Cette fois, le certificat SSL devrait être g Accédez au tableau de bord en local sur `http://ipdevotreserveur:81` Sur la gauche, vous verrez la liste des services actuellement « proxifiés » (aucun pour l'instant). Sur la droite, la liste des IP bannies. En dessous, différents indicateurs. Pour plus de détails, [cliquez ici](https://www.linuxserver.io/blog/introducing-swag-dashboard). -![picture](/img/serveex/swag-dashboard.png) +![Tableau de bord SWAG affichant les services proxifiés et les IP bannies](/img/serveex/swag-dashboard.png) ## DBIP DBIP permet de bloquer les connexions selon les pays. Il s'appuie sur le fichier de configuration nommé `dbip.conf` situé dans `/srv/docker/swag/config/nginx`. [Plus d'infos ici](https://virtualize.link/secure/). @@ -290,7 +290,7 @@ Il est temps d'exposer Dockge sur internet pour accéder à vos conteneurs et le ::warning -Dockge ne gère pas l'authentification multifacteur. L'exposer en ligne pourrait compromettre toutes les machines reliées. Ne le faites que si vous utilisez une solution MFA comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +Dockge ne gère pas l'authentification multifacteur. L'exposer en ligne pourrait compromettre toutes les machines reliées. Ne le faites que si vous utilisez une solution MFA comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: ::steps{level="3"} diff --git a/content/fr/3.serveex/3.security/2.cloudflare.md b/content/fr/3.serveex/3.security/2.cloudflare.md index 08c9d23..9fba3f1 100644 --- a/content/fr/3.serveex/3.security/2.cloudflare.md +++ b/content/fr/3.serveex/3.security/2.cloudflare.md @@ -60,7 +60,7 @@ Vous devez vous inscrire à _Cloudflare Teams_ pour pouvoir accéder au tableau Inscrivez-vous [via ce lien](https://one.dash.cloudflare.com/). -## Configuration de Swag +## Configuration de SWAG ::note Nous partons du principe que vous avez le domaine `mondomaine.fr` avec les DNS qui pointent bien vers ceux de Cloudflare, comme vu précédemment. diff --git a/content/fr/3.serveex/3.security/3.tinyauth.md b/content/fr/3.serveex/3.security/3.tinyauth.md index 95c68e0..8f71f1b 100644 --- a/content/fr/3.serveex/3.security/3.tinyauth.md +++ b/content/fr/3.serveex/3.security/3.tinyauth.md @@ -1,12 +1,12 @@ --- title: TinyAuth -description: Installer TinyAuth, un proxy de forward-auth léger, et l'associer à Pocket ID pour ajouter une connexion SSO devant vos applications auto-hébergées. Protéger votre application derrière Swag avec le forward-auth. +description: Installer TinyAuth, un proxy de forward-auth léger, et l'associer à Pocket ID pour ajouter une connexion SSO devant vos applications auto-hébergées. Protéger votre application derrière SWAG avec le forward-auth. --- :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -[TinyAuth](https://tinyauth.app) est une application qui permet de forcer une authentification avant d'accéder à un service : une page de connexion que Swag peut insérer devant n'importe quelle application avant de laisser passer une requête, en vérifiant si le visiteur est authentifié avant de le rediriger. +[TinyAuth](https://tinyauth.app) est une application qui permet de forcer une authentification avant d'accéder à un service : une page de connexion que SWAG peut insérer devant n'importe quelle application avant de laisser passer une requête, en vérifiant si le visiteur est authentifié avant de le rediriger. ![tinyauth](/img/serveex/tinyauth.png) @@ -135,7 +135,7 @@ Elle redemande l'identifiant, le mot de passe et le code à 6 chiffres du moment À partir de maintenant, cet utilisateur a besoin à la fois de son mot de passe et d'un code valide de son application d'authentification pour se connecter. -## Exposer TinyAuth avec Swag +## Exposer TinyAuth avec SWAG TinyAuth a besoin de son propre sous-domaine : c'est la page sur laquelle les utilisateurs arrivent avant d'être redirigés vers l'application qu'ils veulent réellement. ::note @@ -174,7 +174,7 @@ Nous partons ici du principe que le nom du réseau de TinyAuth est `tinyauth_def ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `tinyauth.subdomain.conf` : +Dans les dossiers de SWAG, créez le fichier `tinyauth.subdomain.conf` : ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ utilisez **File Browser Quantum** pour naviguer et modifier les fichiers plutôt que des commandes dans le terminal. @@ -225,7 +225,7 @@ __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: ## Protéger une application via le reverse proxy -Swag ne fournit pas de fichier d'inclusion tout prêt pour TinyAuth, nous ajouterons donc la vérification forward-auth directement dans le `*.subdomain.conf` de l'application. Nous prendrons Dockge en exemple. +SWAG ne fournit pas de fichier d'inclusion tout prêt pour TinyAuth, nous ajouterons donc la vérification forward-auth directement dans le `*.subdomain.conf` de l'application. Nous prendrons Dockge en exemple. ::steps{level="3"} ### Ouvrir le fichier subdomain.conf de l'application diff --git a/content/fr/3.serveex/3.security/4.pocket-id.md b/content/fr/3.serveex/3.security/4.pocket-id.md index ff34e47..0bddff8 100644 --- a/content/fr/3.serveex/3.security/4.pocket-id.md +++ b/content/fr/3.serveex/3.security/4.pocket-id.md @@ -96,7 +96,7 @@ TRUST_PROXY=true |----------|-------|---------| | `APP_URL`{lang=properties} | L'URL publique par laquelle vous joindrez Pocket ID (voir l'exposition plus bas) | `https://id.mondomaine.fr` | | `ENCRYPTION_KEY`{lang=properties} | La clé générée ci-dessus | `Q2pVEqsTNRkJSO9SkJzU3KZ2...` | -| `TRUST_PROXY`{lang=properties} | Nécessaire puisque Pocket ID se trouve derrière Swag | `true` | +| `TRUST_PROXY`{lang=properties} | Nécessaire puisque Pocket ID se trouve derrière SWAG | `true` | Déployez la stack. L'interface locale est disponible sur `http://ipdevotreserveur:1411`. @@ -114,7 +114,7 @@ Pocket ID n'utilise pas de mots de passe : votre premier compte est créé avec Les passkeys exigent un contexte sécurisé : HTTPS, ou `localhost`. Enregistrer une passkey depuis `http://ipdevotreserveur:1411` sur une autre machine sera refusé par le navigateur, puisque c'est du HTTP simple vers une adresse qui n'est pas `localhost`. Si la configuration ne se termine pas en local, exposez d'abord Pocket ID (voir plus bas) et terminez la configuration en HTTPS. :: -## Exposer Pocket ID avec Swag +## Exposer Pocket ID avec SWAG Les autres applications doivent joindre Pocket ID en HTTPS pour finaliser le processus de connexion OIDC, il doit donc être exposé même si vous ne l'utilisez que depuis chez vous. ::note @@ -153,7 +153,7 @@ Nous partons ici du principe que le nom du réseau de Pocket ID est `pocket-id_d ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `id.subdomain.conf` : +Dans les dossiers de SWAG, créez le fichier `id.subdomain.conf` : ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ utilisez **File Browser Quantum** pour naviguer et modifier les fichiers plutôt que des commandes dans le terminal. diff --git a/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md b/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md index 46a58aa..8ddc77d 100644 --- a/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md +++ b/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md @@ -6,7 +6,9 @@ description: Installer Uptime-Kuma pour surveiller la disponibilité de vos serv :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -![picture](/img/serveex/uptime_kuma.jpg) +[Uptime-Kuma](https://github.com/louislam/uptime-kuma) est un outil de surveillance auto-hébergé qui vérifie régulièrement si vos autres services et sites sont en ligne et joignables, et vous alerte dès que l'un d'eux tombe. Il permet aussi de construire une page de statut publique pour partager l'état de vos services avec d'autres personnes. + +![Tableau de bord Uptime-Kuma affichant les services surveillés et leur statut](/img/serveex/uptime_kuma.jpg) ## Installation @@ -65,7 +67,7 @@ __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. ### Terminé ! :: -## Exposer avec Swag +## Exposer avec SWAG ::note{icon=""} 📋 __Au préalable :__

              @@ -74,13 +76,13 @@ Nous partons du principe que vous avez le sous-domaine `stats.mondomaine.fr` ave ::warning -Uptime-Kuma n'utilise pas d'authentification multifacteur. L'exposer sur internet pourrait compromettre les machines qu'il surveille. Ne le faites que si vous utilisez un système MFA comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG, utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +Uptime-Kuma n'utilise pas d'authentification multifacteur. L'exposer sur internet pourrait compromettre les machines qu'il surveille. Ne le faites que si vous utilisez un système MFA comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG, utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: ::steps{level="3"} ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `stats.subdomain.conf`. +Dans les dossiers de SWAG, créez le fichier `stats.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce pour les allergiques au terminal :__ diff --git a/content/fr/3.serveex/4.monitoring/2.dozzle.md b/content/fr/3.serveex/4.monitoring/2.dozzle.md index 56b37ab..0a9743b 100644 --- a/content/fr/3.serveex/4.monitoring/2.dozzle.md +++ b/content/fr/3.serveex/4.monitoring/2.dozzle.md @@ -104,14 +104,14 @@ Déployez le conteneur. Allez sur `http://ipdevotreserveur:9135`. Et voilà, vot ### Terminé ! :: -## Exposer Dozzle avec Swag +## Exposer Dozzle avec SWAG ::warning -Dozzle n'utilise pas d'authentification multifacteur. L'exposer sur internet pourrait compromettre les machines auxquelles il est relié. Ne le faites que si vous utilisez un système d'authentification multifacteur comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG et utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +Dozzle n'utilise pas d'authentification multifacteur. L'exposer sur internet pourrait compromettre les machines auxquelles il est relié. Ne le faites que si vous utilisez un système d'authentification multifacteur comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG et utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: -Vous voudrez peut-être accéder à Dozzle à distance et sur tous vos appareils. Pour cela, nous allons exposer Dozzle via Swag. +Vous voudrez peut-être accéder à Dozzle à distance et sur tous vos appareils. Pour cela, nous allons exposer Dozzle via SWAG. ::note{icon=""} 📋 __Au préalable :__ @@ -150,7 +150,7 @@ Nous partons du principe que le nom du réseau de Dozzle est `dozzle_default`. V ### Créer le fichier subdomain.conf -Dans le dossier de Swag, créez le fichier `dozzle.subdomain.conf`. +Dans le dossier de SWAG, créez le fichier `dozzle.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ vous pouvez utiliser **File Browser Quantum** pour naviguer et modifier vos fichiers plutôt que des commandes dans le terminal. diff --git a/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md b/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md index e836f5f..c9388a2 100644 --- a/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md +++ b/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md @@ -102,7 +102,7 @@ Nous voulons maintenant exposer Speedtest Tracker sur internet pour y accéder ::warning -Speedtest Tracker n'utilise pas d'authentification multifacteur. L'exposer sur internet pourrait compromettre les appareils connectés. Ne le faites que si vous utilisez un système multifacteur comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, évitez SWAG et préférez un VPN comme [Wireguard](/serveex/core/wireguard). +Speedtest Tracker n'utilise pas d'authentification multifacteur. L'exposer sur internet pourrait compromettre les appareils connectés. Ne le faites que si vous utilisez un système multifacteur comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, évitez SWAG et préférez un VPN comme [WireGuard](/serveex/core/wireguard). :: ::steps{level="3"} diff --git a/content/fr/3.serveex/4.monitoring/4.beszel.md b/content/fr/3.serveex/4.monitoring/4.beszel.md index 11416f5..8be690b 100644 --- a/content/fr/3.serveex/4.monitoring/4.beszel.md +++ b/content/fr/3.serveex/4.monitoring/4.beszel.md @@ -182,14 +182,14 @@ Déployez la stack sur le serveur distant. Les données commenceront à remonter __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: -## Exposer Beszel avec Swag +## Exposer Beszel avec SWAG ::warning -Beszel ne gère pas l'authentification multifacteur. L'exposer sur internet pourrait compromettre les machines connectées. Ne le faites que si vous utilisez un système comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +Beszel ne gère pas l'authentification multifacteur. L'exposer sur internet pourrait compromettre les machines connectées. Ne le faites que si vous utilisez un système comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: -Si vous voulez accéder à Beszel à distance depuis tous vos appareils, exposez-le avec Swag. +Si vous voulez accéder à Beszel à distance depuis tous vos appareils, exposez-le avec SWAG. ::note{icon="" to="/general/networking/nat"} 📋 __Au préalable :__ @@ -200,7 +200,7 @@ Vous devez avoir créé un sous-domaine DNS du type `beszel.mondomaine.fr` avec ::steps{level="3"} ### Ajouter le réseau de Beszel à SWAG -Dans Dockge, modifiez le fichier compose de Swag et ajoutez le réseau de Beszel : +Dans Dockge, modifiez le fichier compose de SWAG et ajoutez le réseau de Beszel : ```yaml [compose.yaml] --- @@ -219,16 +219,16 @@ networks: external: true ``` -Redéployez la stack et attendez que Swag soit pleinement opérationnel. +Redéployez la stack et attendez que SWAG soit pleinement opérationnel. ::note -Nous partons du principe que le nom du réseau est `beszel_default`. Vous pouvez vérifier la connectivité en visitant le tableau de bord de Swag sur `http://ipdevotreserveur:81`. +Nous partons du principe que le nom du réseau est `beszel_default`. Vous pouvez vérifier la connectivité en visitant le tableau de bord de SWAG sur `http://ipdevotreserveur:81`. :: ### Créer le fichier subdomain.conf -Dans les dossiers de configuration de Swag, créez `beszel.subdomain.conf`. +Dans les dossiers de configuration de SWAG, créez `beszel.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ utilisez **File Browser Quantum** pour naviguer et modifier vos fichiers plutôt que des commandes dans le terminal. diff --git a/content/fr/3.serveex/4.monitoring/5.upsnap.md b/content/fr/3.serveex/4.monitoring/5.upsnap.md index 717f57e..e52737a 100644 --- a/content/fr/3.serveex/4.monitoring/5.upsnap.md +++ b/content/fr/3.serveex/4.monitoring/5.upsnap.md @@ -85,14 +85,14 @@ Déployez le conteneur et allez sur `http://ipdevotreserveur:8095`. Suivez simpl __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: -## Exposer UpSnap avec Swag +## Exposer UpSnap avec SWAG ::warning -UpSnap ne gère pas l'authentification multifacteur. L'exposer sur internet pourrait compromettre les machines connectées. Ne le faites que si vous utilisez un système d'authentification multifacteur comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, évitez de l'exposer avec SWAG et utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +UpSnap ne gère pas l'authentification multifacteur. L'exposer sur internet pourrait compromettre les machines connectées. Ne le faites que si vous utilisez un système d'authentification multifacteur comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, évitez de l'exposer avec SWAG et utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: -Vous voudrez peut-être y accéder à distance depuis tous vos appareils. Pour cela, nous allons exposer UpSnap via Swag. +Vous voudrez peut-être y accéder à distance depuis tous vos appareils. Pour cela, nous allons exposer UpSnap via SWAG. ::note{icon=""} 📋 __Au préalable :__ @@ -131,7 +131,7 @@ Nous partons ici du principe que le nom du réseau d'upsnap est `upsnap_default` ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `upsnap.subdomain.conf`. +Dans les dossiers de SWAG, créez le fichier `upsnap.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ vous pouvez utiliser **File Browser Quantum** pour naviguer dans vos fichiers et éditer vos documents plutôt que des commandes dans le terminal. diff --git a/content/fr/3.serveex/5.media/1.jellyfin.md b/content/fr/3.serveex/5.media/1.jellyfin.md index ea364d5..ea9f694 100644 --- a/content/fr/3.serveex/5.media/1.jellyfin.md +++ b/content/fr/3.serveex/5.media/1.jellyfin.md @@ -16,7 +16,7 @@ Comme toujours, nous utiliserons l'[image linuxserver.io](https://docs.linuxserv ::note{to="/serveex/core/wireguard"} -Contrairement à Plex, Jellyfin n'a pas de relais cloud : pour accéder à votre serveur en dehors de votre réseau local, vous devez l'exposer vous-même (voir plus bas), ou utiliser un VPN comme **Wireguard**. +Contrairement à Plex, Jellyfin n'a pas de relais cloud : pour accéder à votre serveur en dehors de votre réseau local, vous devez l'exposer vous-même (voir plus bas), ou utiliser un VPN comme **WireGuard**. :: ## Installer Jellyfin diff --git a/content/fr/3.serveex/5.media/2.qbittorrent.md b/content/fr/3.serveex/5.media/2.qbittorrent.md index 44e9962..c378bf8 100644 --- a/content/fr/3.serveex/5.media/2.qbittorrent.md +++ b/content/fr/3.serveex/5.media/2.qbittorrent.md @@ -1,24 +1,24 @@ --- -title: Qbittorrent +title: qBittorrent description: Installer qBittorrent avec Gluetun et ProtonVPN pour télécharger des torrents de manière sécurisée derrière un VPN sur votre serveur auto-hébergé. --- :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -![Picture](/img/serveex/qbit-vue.jpeg) +![Interface web de VueTorrent affichant des téléchargements actifs](/img/serveex/qbit-vue.jpeg) Afin de télécharger vos media favoris en toute sécurité, nous allons monter un système à base de : - [Qbittorent](https://github.com/linuxserver/docker-qbittorrent) comme logiciel de téléchargement bittorent - [Proton VPN Plus](https://protonvpn.com/torrenting), VPN pour sécuriser vos échanges, auquel vous devez souscrire (il y a de nombreux codes promo) pour accéder au protocole Bittorent, mais vous pouvez également en choisir un autre, à condition qu'il propose le protocole bittorent. - [Gluetun](https://github.com/qdm12/gluetun) -- [Qbittorrent port update](https://codeberg.org/TechnoSam/qbittorrent-gluetun-port-update) pour mettre automatiquement à jour le port de votre VPN (qui change régulièrement). +- [qBittorrent port update](https://codeberg.org/TechnoSam/qbittorrent-gluetun-port-update) pour mettre automatiquement à jour le port de votre VPN (qui change régulièrement). - Et le mode [vuetorrent](https://github.com/gabe565/linuxserver-mod-vuetorrent) pour une interface moderne et intuitive. Nous monterons ici le système ci-dessous : -![Picture](/img/serveex/qbit.svg) +![Schéma du trafic de qBittorrent passant par le tunnel VPN Gluetun](/img/serveex/qbit.svg) ## Configuration @@ -34,7 +34,7 @@ tree: - gluetun/ - compose.yaml - .env - - "media # relié à Jellyfin et Qbittorrent": + - "media # relié à Jellyfin et qBittorrent": - "downloads/ # téléchargements génériques, choisis dans les réglages" - "movies/ # utilisé pour télécharger les films" - "tvseries/ # utilisé pour télécharger les séries" @@ -122,7 +122,7 @@ services: ### Configurer la mise à jour du port de téléchargement -Avant de renseigner le `.env` dans Dockge, configurons la mise à jour du port de téléchargement. Proton et la plupart des VPN font tourner le port de redirection, qui doit être communiqué à Qbittorrent. +Avant de renseigner le `.env` dans Dockge, configurons la mise à jour du port de téléchargement. Proton et la plupart des VPN font tourner le port de redirection, qui doit être communiqué à qBittorrent. Nous avons ajouté le mod `ghcr.io/t-anc/gsp-qbittorent-gluetun-sync-port-mod` au conteneur. @@ -181,8 +181,8 @@ Détail : | `UI_PORT` | Port d'accès à l'interface web | `5695` | | `PR_KEY` | Clé privée fournie par Proton | `buKsjNHLyzKMM1qYnzOy4s7SHfly` | | `GSP_KEY` | Clé générée pour la mise à jour du port | `MnBa47MeVmk7xiv` | -| `ID` | Identifiant de connexion à l'interface Qbittorrent | `user` | -| `PW` | Mot de passe de l'interface Qbittorrent | `password` | +| `ID` | Identifiant de connexion à l'interface qBittorrent | `user` | +| `PW` | Mot de passe de l'interface qBittorrent | `password` | ### Terminé ! :: @@ -217,7 +217,7 @@ Changez votre identifiant et votre mot de passe dans les réglages « webui ». ### Terminé ! :: -C'est terminé ! Dans les réglages de Qbittorrent, section « Téléchargements », définissez `/media/downloads` comme dossier par défaut. +C'est terminé ! Dans les réglages de qBittorrent, section « Téléchargements », définissez `/media/downloads` comme dossier par défaut. Lors de l'ajout d'un téléchargement, pensez à choisir le bon dossier pour que Jellyfin se synchronise correctement (`/media/movies` ou `/media/tvseries`). Vous pouvez aussi automatiser cela avec des catégories et des dossiers. @@ -225,10 +225,10 @@ Lors de l'ajout d'un téléchargement, pensez à choisir le bon dossier pour que ::warning -Qbittorrent ne gère pas l'authentification multifacteur. L'exposer sur internet peut mettre votre système en danger. Ne le faites que si vous utilisez du MFA via [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +qBittorrent ne gère pas l'authentification multifacteur. L'exposer sur internet peut mettre votre système en danger. Ne le faites que si vous utilisez du MFA via [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: -Pour lancer des téléchargements depuis l'extérieur, sans VPN, vous pouvez exposer l'interface web de Qbittorrent. +Pour lancer des téléchargements depuis l'extérieur, sans VPN, vous pouvez exposer l'interface web de qBittorrent. ::note @@ -334,9 +334,9 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et ### Terminé ! :: -Attendez quelques minutes, puis allez sur `https://seedbox.mondomaine.fr`. Vous devriez arriver sur l'interface de Qbittorrent. +Attendez quelques minutes, puis allez sur `https://seedbox.mondomaine.fr`. Vous devriez arriver sur l'interface de qBittorrent. -## Protéger Qbittorrent avec TinyAuth +## Protéger qBittorrent avec TinyAuth Ajoutez la vérification forward-auth de [TinyAuth](/serveex/security/tinyauth) directement dans `seedbox.subdomain.conf`, de la même façon que dans [le tutoriel TinyAuth](/serveex/security/tinyauth#protéger-une-application-via-le-reverse-proxy) : ```nginx [seedbox.subdomain.conf]{26-38,41-42} @@ -418,4 +418,4 @@ Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWA Et voilà ! Vous avez maintenant un media center prêt à l'emploi. -![Picture](/img/serveex/seed.svg) +![Schéma complet de la seedbox, de qBittorrent à SWAG](/img/serveex/seed.svg) diff --git a/content/fr/3.serveex/5.media/3.servarr.md b/content/fr/3.serveex/5.media/3.servarr.md index 2b10de0..b1585ce 100644 --- a/content/fr/3.serveex/5.media/3.servarr.md +++ b/content/fr/3.serveex/5.media/3.servarr.md @@ -49,7 +49,7 @@ tree: ::warning -__Attention :__ respectez bien cette structure de fichiers, en particulier le dossier `media`. Ce dossier doit être monté **exactement de la même façon** dans le fichier compose de _Qbittorrent_ (`/votre/chemin/media:/media`) et dans les applications _arr_. Sinon, les applications _arr_ risquent de ne pas reconnaître le chemin fourni par Qbittorrent et ne créeront pas de _hardlinks_. Sans hardlinks, les applications _arr_ copieront les fichiers, ce qui **doublera l'espace utilisé** sur votre stockage. +__Attention :__ respectez bien cette structure de fichiers, en particulier le dossier `media`. Ce dossier doit être monté **exactement de la même façon** dans le fichier compose de _Qbittorrent_ (`/votre/chemin/media:/media`) et dans les applications _arr_. Sinon, les applications _arr_ risquent de ne pas reconnaître le chemin fourni par qBittorrent et ne créeront pas de _hardlinks_. Sans hardlinks, les applications _arr_ copieront les fichiers, ce qui **doublera l'espace utilisé** sur votre stockage. :: ::steps{level="3"} @@ -170,7 +170,7 @@ MEDIA_PATH= |----------------|-------------------------------------------------------------------------------------------------|-------------| | `PUID` | À renseigner avec vos informations utilisateur (à vérifier avec `id votreutilisateur`) | `1000` | | `PGID` | Idem | `1000` | -| `MEDIA_PATH` | Chemin de votre dossier média, ici `/media`. Il doit correspondre à celui utilisé par Qbittorrent. | `/media` | +| `MEDIA_PATH` | Chemin de votre dossier média, ici `/media`. Il doit correspondre à celui utilisé par qBittorrent. | `/media` | ::note @@ -207,7 +207,7 @@ Créez un compte et choisissez *forms login*. ::warning -__Attention :__ si vous avez déjà des films dans `movies` provenant de Qbittorrent, ne laissez pas Radarr les ajouter. Radarr pourrait les modifier, ce qui interromprait le seed dans Qbittorrent. +__Attention :__ si vous avez déjà des films dans `movies` provenant de qBittorrent, ne laissez pas Radarr les ajouter. Radarr pourrait les modifier, ce qui interromprait le seed dans qBittorrent. :: #### Configurer les profils @@ -216,12 +216,12 @@ Allez dans *Settings > Profiles*. Ce sont vos profils de qualité par défaut. Q ![profiles_radarr](/img/serveex/radarr1.png) -#### Ajouter Qbittorrent +#### Ajouter qBittorrent -Dans *Settings > Download Clients*, ajoutez Qbittorrent. +Dans *Settings > Download Clients*, ajoutez qBittorrent. - Utilisez l'IP de votre serveur comme *Host* et le port `5695` si vous suivez ce guide. -- Renseignez vos *Username* et *Password* Qbittorrent. +- Renseignez vos *Username* et *Password* qBittorrent. - Cliquez sur *Test*. - Si le test réussit, cliquez sur *Save*. @@ -389,7 +389,7 @@ Il peut être utile d'exposer Seerr si vous voulez envoyer des demandes depuis l ::warning -Seerr n'a pas d'authentification à deux facteurs intégrée. Ne l'exposez que si vous utilisez une solution d'authentification robuste comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik). Sinon, ne l'exposez pas avec SWAG, utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +Seerr n'a pas d'authentification à deux facteurs intégrée. Ne l'exposez que si vous utilisez une solution d'authentification robuste comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik). Sinon, ne l'exposez pas avec SWAG, utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: ::note diff --git a/content/fr/3.serveex/6.cloud/1.immich.md b/content/fr/3.serveex/6.cloud/1.immich.md index 34343a6..c08ad95 100644 --- a/content/fr/3.serveex/6.cloud/1.immich.md +++ b/content/fr/3.serveex/6.cloud/1.immich.md @@ -8,7 +8,7 @@ description: Installer Immich, une alternative auto-hébergée à Google Photos [Immich](https://immich.app/docs/overview/introduction) est une solution auto-hébergée de gestion de photos et de vidéos qui remplace les services cloud comme Google Photos ou iCloud. Elle propose des fonctions puissantes comme la reconnaissance faciale et la géolocalisation. -![Picture](/img/serveex/immich.png) +![Interface web d'Immich affichant la chronologie d'une photothèque](/img/serveex/immich.png) ## Installation diff --git a/content/fr/3.serveex/6.cloud/2.nextcloud.md b/content/fr/3.serveex/6.cloud/2.nextcloud.md index d89511d..173b98f 100644 --- a/content/fr/3.serveex/6.cloud/2.nextcloud.md +++ b/content/fr/3.serveex/6.cloud/2.nextcloud.md @@ -8,7 +8,7 @@ description: Installer Nextcloud pour auto-héberger vos fichiers, photos et age [Nextcloud](https://nextcloud.com/) est une solution auto-hébergée qui permet d'accéder à vos données et de les synchroniser sur tous vos appareils. Elle inclut aussi des fonctions de collaboration, un agenda, et bien plus. C'est une excellente alternative à des services comme Google Drive, iCloud ou OneDrive. -![Picture](/img/serveex/nextcloud.png) +![Interface web de Nextcloud affichant fichiers et dossiers](/img/serveex/nextcloud.png) ## Installation ::note{to="https://docs.linuxserver.io/images/docker-nextcloud/"} @@ -84,8 +84,8 @@ Déployez la stack et visitez `http://ipdevotreserveur:4545` pour terminer la co __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: -## Exposer Nextcloud avec Swag -L'objectif de cette installation est d'accéder à Nextcloud à distance depuis tous vos appareils. Nous allons utiliser Swag pour exposer l'application. +## Exposer Nextcloud avec SWAG +L'objectif de cette installation est d'accéder à Nextcloud à distance depuis tous vos appareils. Nous allons utiliser SWAG pour exposer l'application. ::note @@ -155,7 +155,7 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `nextcloud.subdomain.conf` : +Dans les dossiers de SWAG, créez le fichier `nextcloud.subdomain.conf` : ```bash [Terminal] sudo nano /srv/docker/swag/config/nginx/proxy-confs/nextcloud.subdomain.conf diff --git a/content/fr/3.serveex/7.files/1.file-browser-quantum.md b/content/fr/3.serveex/7.files/1.file-browser-quantum.md index a0e10b7..07d1eea 100644 --- a/content/fr/3.serveex/7.files/1.file-browser-quantum.md +++ b/content/fr/3.serveex/7.files/1.file-browser-quantum.md @@ -104,14 +104,14 @@ Déployez le conteneur et allez sur `http://ipdevotreserveur:8020`. Connectez-vo __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: -## Exposer File Browser Quantum avec Swag +## Exposer File Browser Quantum avec SWAG ::warning -File Browser Quantum ne gère pas l'authentification multifacteur. L'exposer publiquement pourrait mettre vos systèmes en danger. Ne le faites que si vous utilisez une solution d'authentification robuste comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +File Browser Quantum ne gère pas l'authentification multifacteur. L'exposer publiquement pourrait mettre vos systèmes en danger. Ne le faites que si vous utilisez une solution d'authentification robuste comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: -Vous voudrez peut-être accéder à File Browser Quantum à distance depuis tous vos appareils. Pour cela, nous allons l'exposer à travers Swag. +Vous voudrez peut-être accéder à File Browser Quantum à distance depuis tous vos appareils. Pour cela, nous allons l'exposer à travers SWAG. ::note{icon=""} @@ -149,7 +149,7 @@ Redémarrez la stack en cliquant sur « deploy » et attendez que SWAG soit comp ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `fbq.subdomain.conf`. +Dans les dossiers de SWAG, créez le fichier `fbq.subdomain.conf`. ```bash [Terminal] sudo nano /srv/docker/swag/config/nginx/proxy-confs/fbq.subdomain.conf diff --git a/content/fr/3.serveex/7.files/2.pingvin.md b/content/fr/3.serveex/7.files/2.pingvin.md index b219e86..3a7a698 100644 --- a/content/fr/3.serveex/7.files/2.pingvin.md +++ b/content/fr/3.serveex/7.files/2.pingvin.md @@ -8,7 +8,7 @@ description: Installer Pingvin Share, une plateforme de partage de fichiers auto [Pingvin](https://github.com/stonith404/pingvin-share) est un outil pour partager rapidement des fichiers, à la manière de WeTransfer. Ses nombreuses options de partage (mot de passe, durée d'expiration, lien personnalisé, etc.) en font l'outil idéal pour partager des fichiers rapidement. Pingvin peut aussi créer des _demandes d'envoi_, c'est-à-dire un lien partageable à envoyer à quelqu'un pour qu'il dépose ses fichiers et que vous les récupériez. -![picture](/img/serveex/pingvin.png) +![Interface web de Pingvin Share pour envoyer et partager des fichiers](/img/serveex/pingvin.png) ## Installation @@ -42,7 +42,7 @@ services: ``` ::note -À partir d'ici, nous partons du principe que le nom du réseau de Swag est `swag_default`. +À partir d'ici, nous partons du principe que le nom du réseau de SWAG est `swag_default`. :: ::tip{icon=""} @@ -74,8 +74,8 @@ Déployez le conteneur et allez sur `http://ipdevotreserveur:3600`. Et voilà ! __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: -## Exposer Pingvin avec Swag -Tout l'intérêt d'une solution comme celle-ci est de pouvoir y accéder à distance, depuis tous vos appareils. Pour cela, nous allons exposer Pingvin à travers Swag. +## Exposer Pingvin avec SWAG +Tout l'intérêt d'une solution comme celle-ci est de pouvoir y accéder à distance, depuis tous vos appareils. Pour cela, nous allons exposer Pingvin à travers SWAG. ::note{icon=""} 📋 __Au préalable :__

              @@ -113,7 +113,7 @@ Redéployez la stack en cliquant sur « deploy » et attendez que SWAG soit comp ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `pingvin.subdomain.conf`. +Dans les dossiers de SWAG, créez le fichier `pingvin.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} @@ -224,15 +224,15 @@ Dans l'espace d'administration d'Authentik, créez un provider OAuth2/OpenID. Remplissez chaque section comme suit, en remplaçant `mondomaine.fr` par votre propre domaine. Copiez les champs `Client ID` et `Client Secret` en lieu sûr. -![picture](/img/serveex/pingvin-auth1.png) -![picture](/img/serveex/pingvin-auth2.png) -![picture](/img/serveex/pingvin-auth3.png) +![Écran de configuration du fournisseur OAuth2/OpenID d'Authentik, partie 1](/img/serveex/pingvin-auth1.png) +![Écran de configuration du fournisseur OAuth2/OpenID d'Authentik, partie 2](/img/serveex/pingvin-auth2.png) +![Écran de configuration du fournisseur OAuth2/OpenID d'Authentik, partie 3](/img/serveex/pingvin-auth3.png) #### Créer l'application Enregistrez et créez une application `pingvin` comme suit. -![picture](/img/serveex/pingvin-auth4.png) +![Écran de création de l'application Authentik pour Pingvin Share](/img/serveex/pingvin-auth4.png) #### Ajouter le provider à votre outpost diff --git a/content/fr/3.serveex/8.development/1.code-server.md b/content/fr/3.serveex/8.development/1.code-server.md index e521cda..8436387 100644 --- a/content/fr/3.serveex/8.development/1.code-server.md +++ b/content/fr/3.serveex/8.development/1.code-server.md @@ -118,8 +118,8 @@ services: ``` Une fois dans VS Code, vous aurez accès au dossier monté. -## Exposer code-server avec Swag -Tout l'intérêt d'une telle solution est d'y accéder à distance depuis n'importe quel appareil. Pour cela, nous allons exposer code-server via Swag. +## Exposer code-server avec SWAG +Tout l'intérêt d'une telle solution est d'y accéder à distance depuis n'importe quel appareil. Pour cela, nous allons exposer code-server via SWAG. ::note @@ -157,7 +157,7 @@ Redéployez la stack en cliquant sur « deploy » et attendez que SWAG soit plei ### Créer le fichier subdomain.conf -Dans les dossiers de configuration de Swag, créez le fichier `code.subdomain.conf`. +Dans les dossiers de configuration de SWAG, créez le fichier `code.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ vous pouvez utiliser **File Browser Quantum** pour naviguer et modifier vos fichiers plutôt que des commandes dans le terminal. diff --git a/content/fr/3.serveex/8.development/2.forgejo.md b/content/fr/3.serveex/8.development/2.forgejo.md index 32566b8..905f9eb 100644 --- a/content/fr/3.serveex/8.development/2.forgejo.md +++ b/content/fr/3.serveex/8.development/2.forgejo.md @@ -73,8 +73,8 @@ Déployez le conteneur et allez sur `http://ipdevotreserveur:3333`. Votre instan __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: -## Exposer Forgejo avec Swag -L'intérêt de cette installation est de pouvoir y accéder à distance depuis n'importe lequel de vos appareils. Pour cela, nous allons exposer Forgejo à travers Swag. +## Exposer Forgejo avec SWAG +L'intérêt de cette installation est de pouvoir y accéder à distance depuis n'importe lequel de vos appareils. Pour cela, nous allons exposer Forgejo à travers SWAG. ::note @@ -112,7 +112,7 @@ Redéployez la stack en cliquant sur « Deploy » et attendez que SWAG soit plei ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `forgejo.subdomain.conf`. +Dans les dossiers de SWAG, créez le fichier `forgejo.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ vous pouvez utiliser **File Browser Quantum** pour naviguer et modifier vos fichiers plutôt que des commandes dans le terminal. diff --git a/content/fr/3.serveex/8.development/3.it-tools.md b/content/fr/3.serveex/8.development/3.it-tools.md index 0dd71d3..572a256 100644 --- a/content/fr/3.serveex/8.development/3.it-tools.md +++ b/content/fr/3.serveex/8.development/3.it-tools.md @@ -51,8 +51,8 @@ Déployez le conteneur et visitez `http://ipdevotreserveur:3222`. Voilà, votre __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: -## Exposer IT Tools avec Swag -Vous voudrez peut-être y accéder à distance sur tous vos appareils. Pour cela, nous allons exposer IT Tools avec Swag. +## Exposer IT Tools avec SWAG +Vous voudrez peut-être y accéder à distance sur tous vos appareils. Pour cela, nous allons exposer IT Tools avec SWAG. ::note @@ -95,7 +95,7 @@ Redémarrez la stack en cliquant sur « deploy » et attendez que SWAG soit plei ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `tools.subdomain.conf`. +Dans les dossiers de SWAG, créez le fichier `tools.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ vous pouvez utiliser **File Browser Quantum** pour naviguer et modifier vos fichiers plutôt que des commandes dans le terminal. diff --git a/content/fr/3.serveex/9.apps/1.adguard.md b/content/fr/3.serveex/9.apps/1.adguard.md index 0054c49..e0f09ce 100644 --- a/content/fr/3.serveex/9.apps/1.adguard.md +++ b/content/fr/3.serveex/9.apps/1.adguard.md @@ -1,5 +1,5 @@ --- -title: Adguard Home +title: AdGuard Home description: Installer AdGuard Home pour bloquer publicités et trackers à l'échelle du réseau avec DNS-over-HTTPS, gestion des clients et règles de filtrage personnalisées. --- @@ -12,7 +12,7 @@ Il fonctionne comme un serveur DNS qui redirige les domaines de suivi vers un « En pratique, une fois en place, il vous faudra juste configurer les serveurs DNS de vos appareils, pour que ces derniers l'utilisent. -![adguard](/img/serveex/adguard.png) +![AdGuard](/img/serveex/adguard.png) **Rappel sur le fonctionnement d'un DNS :** @@ -20,14 +20,14 @@ Lorsque vous naviguez sur un site, ou une application, des requêtes sont émise Par défaut, votre appareil utilise le serveur de votre fournisseur d'accès, paramétré dans votre box ou directement sur le CGNAT de votre opérateur si appareil mobile. Cela peut être changé directement dans les réglages de votre navigateur, mais aussi dans le système de votre appareil, et parfois directement dans votre box si votre FAI le permet. -Adguard lui, va s'intercaler entre le serveur de nom et votre appareil. Si vous paramétrez vos appareil, ils contacteront d'abord adguard qui filtrera les requêtes, via des listes régulièrement mises à jour : +AdGuard lui, va s'intercaler entre le serveur de nom et votre appareil. Si vous paramétrez vos appareil, ils contacteront d'abord AdGuard qui filtrera les requêtes, via des listes régulièrement mises à jour : - Si le domaine n'est pas dans une blocklist, il contactera des serveurs de noms génériques (dit upstreams) et répondra vers vos appareils avec l'adresse IP recherchée. - Si le domaine est dans une blocklist, il ne contactera pas les DNS upstream et ne répondra pas à vos appareils. Le contenu affilié à cette requête ne s'affichera pas. C'est ainsi que les pubs et domaines malveillants sont bloqués : leurs domaines sont présents dans la blocklist, le reste de la page lui charge correctement. -![Picture](/img/serveex/adguard.svg) +![Schéma d'AdGuard filtrant une requête DNS selon une liste de blocage](/img/serveex/adguard.svg) ## Installation @@ -47,7 +47,7 @@ tree: ::note -Nous monterons également le dossier `/srv/docker/swag/config/etc/letsencrypt` pour accéder au certificat SSL de Swag. +Nous monterons également le dossier `/srv/docker/swag/config/etc/letsencrypt` pour accéder au certificat SSL de SWAG. :: ::steps{level="3"} @@ -102,7 +102,7 @@ L'assistant de configuration vous demande de choisir un port pour l'interface d' ### Terminé ! :: -C'est tout ! Adguard est déployé. +C'est tout ! AdGuard est déployé. ## Exposer AdGuard avec SWAG Pour rendre AdGuard utilisable en dehors de votre réseau domestique, vous devez l'exposer. @@ -347,23 +347,23 @@ Le bloc `location /tinyauth` s'exécute dans le conteneur de SWAG lui-même, SWA

              Vous pouvez protéger cette app avec Authentik en ouvrant `adguard.subdomain.conf` et en retirant les `#` devant `include /config/nginx/authentik-server.conf;`{lang=nginx} et `include /config/nginx/authentik-location.conf;`{lang=nginx}. n'oubliez pas de [créer une application et un fournisseur dans Authentik](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). Il vous faudra exclure l'url `https://adguard.mondomaine.fr/dns-query` de l'authentification : -- Éditez le fournisseur d'Adguard +- Éditez le fournisseur d'AdGuard - Dans *paramètres avancés du protocole > chemins authentifiés*, saisissez `^/dns-query` :: Enregistrez avec :kbd{value="Ctrl+O"} puis :kbd{value="Entrée"}, puis quittez avec :kbd{value="Ctrl+X"}. -Et voilà, vous exposez Adguard à présent ! +Et voilà, vous exposez AdGuard à présent ! ## Configurer le chiffrement SSL/TLS -Le chiffrement est essentiel si vous souhaitez garder privées les requêtes que vous faites vers adguard. Chiffrer ces requêtes c'est vous assurer que personne, même votre FAI, ne connaisse votre historique. C'est aussi vous assurer que personne d'autre que votre serveur vous répond. +Le chiffrement est essentiel si vous souhaitez garder privées les requêtes que vous faites vers AdGuard. Chiffrer ces requêtes c'est vous assurer que personne, même votre FAI, ne connaisse votre historique. C'est aussi vous assurer que personne d'autre que votre serveur vous répond. Afin de configurer le chiffrement : - Allez dans _paramètre_ puis dans _chiffrement_. - Paramétrez comme suit -![Picture](/img/serveex/adguard-chiffrement.png) +![Écran des réglages de chiffrement d'AdGuard Home](/img/serveex/adguard-chiffrement.png) - Puis en dessous, dans la section _certificats_ cochez _Définir un emplacement de fichier du certificat_ - Dans le champ de saisie, mettez `/swag-ssl/live/mondomaine.fr/fullchain.pem` en remplaçant `mondomaine.fr` par votre domaine principal. @@ -376,7 +376,7 @@ Et voilà ! Vous avez protégé vos futures requêtes DNS ! ## Configurer les appareils Pour configurer vos appareils, vous avez plusieurs choix (que vous pouvez cumuler). ### Sécuriser le réseau local -Vous pouvez sécuriser votre réseau local avec adguard en configurant votre box pour que chaque requête DNS soit dirigée par défaut vers adguard plutôt que les services de votre FAI. Attention, votre box doit pouvoir permettre le changement de DNS (Orange ne le permet pas). +Vous pouvez sécuriser votre réseau local avec AdGuard en configurant votre box pour que chaque requête DNS soit dirigée par défaut vers AdGuard plutôt que les services de votre FAI. Attention, votre box doit pouvoir permettre le changement de DNS (Orange ne le permet pas). Généralement cette option est dans les paramètres _DHCP_ de votre box. Pensez bien à ajouter un serveur secondaire tel que : @@ -390,14 +390,14 @@ En effet, sans cela, si votre serveur tombe, vos appareils n'arriveraient plus Des appareils peuvent avoir un autre DNS paramétré et ne pas utiliser ceux de la box. :: -### Forcer un navigateur à utiliser Adguard +### Forcer un navigateur à utiliser AdGuard -Dans votre navigateur, vous pouvez configurer un DNS pour le forcer à utiliser adguard home. +Dans votre navigateur, vous pouvez configurer un DNS pour le forcer à utiliser AdGuard home. Dans les paramètres, il vous faudra renseigner l'adresse `https://adguard.mondomaine.fr/dns-query` -### Windows, paramétrer Adguard au niveau système +### Windows, paramétrer AdGuard au niveau système -Dans windows, vous devez paramétrer Adguard pour chaque carte réseau que vous souhaitez utiliser. +Dans Windows, vous devez paramétrer AdGuard pour chaque carte réseau que vous souhaitez utiliser. - Rendez vous dans _accueil > Réseau et internet >_ et choisissez votre carte réseau à modifier - Cliquez sur _modifier les DNS_ (parfois dans _propriété du matériel_) @@ -408,7 +408,7 @@ Dans windows, vous devez paramétrer Adguard pour chaque carte réseau que vous - Désactivez _retour au texte en clair_ - Enregistrez -Tous les programmes de votre machine utilisant cette carte réseau seront filtrés par Adguard. +Tous les programmes de votre machine utilisant cette carte réseau seront filtrés par AdGuard. ## Ajouter des filtres diff --git a/content/fr/3.serveex/91.advanced/1.authentik.md b/content/fr/3.serveex/91.advanced/1.authentik.md index 473c283..61de9a0 100644 --- a/content/fr/3.serveex/91.advanced/1.authentik.md +++ b/content/fr/3.serveex/91.advanced/1.authentik.md @@ -25,11 +25,11 @@ Il y a deux modes principaux à connaître : - Le premier permet aux applications gérant nativement le SSO compatible OpenID de se connecter directement à Authentik. C'est la méthode à privilégier, puisque l'application décide elle-même de ce qui est public et de ce qui est protégé. -![Picture](/img/serveex/auth-native.svg) +![Schéma d'une application se connectant nativement à Authentik via OpenID](/img/serveex/auth-native.svg) - La seconde méthode injecte l'authentification Authentik via SWAG avant d'atteindre le service cible. -![Picture](/img/serveex/auth-proxy.svg) +![Schéma d'Authentik injectant l'authentification via SWAG en reverse proxy](/img/serveex/auth-proxy.svg) Les deux modes se configurent application par application. @@ -375,15 +375,15 @@ Pourquoi faire cela alors que Dockge a déjà une authentification ? Parce que D - Choisissez _Applications_ puis _Create with wizard_ - Remplissez les champs comme suit : -![Picture](/img/serveex/auth1.png) +![Assistant de création d'application Authentik](/img/serveex/auth1.png) - À l'étape suivante, choisissez « Forward authentication (single application) » et configurez comme suit (les flows sont importants) : -![Picture](/img/serveex/auth2.png) +![Configuration du fournisseur d'authentification forward-auth d'Authentik](/img/serveex/auth2.png) - Ensuite, allez dans le menu _Outposts_ à gauche et modifiez _authentik Embedded Outpost_ : -![Picture](/img/serveex/auth3.png) +![Liste des applications de l'outpost intégré d'Authentik](/img/serveex/auth3.png) - Ajoutez l'application `dockge` en la déplaçant dans la colonne de droite et enregistrez. @@ -415,7 +415,7 @@ Répétez cette procédure pour chaque application que vous voulez protéger (sa Votre nouvelle architecture ressemble à ceci : -![Picture](/img/serveex/authentik.svg) +![Schéma de l'architecture obtenue avec Authentik protégeant les applications via SWAG](/img/serveex/authentik.svg) ## Protéger un service sur un serveur distant Pour une [application native](/serveex/advanced/authentik/#protecting-a-native-app) (via OAuth 2.0 ou autre), rien ne change. diff --git a/content/fr/3.serveex/91.advanced/2.arcane.md b/content/fr/3.serveex/91.advanced/2.arcane.md index 9f6a4ab..1e50882 100644 --- a/content/fr/3.serveex/91.advanced/2.arcane.md +++ b/content/fr/3.serveex/91.advanced/2.arcane.md @@ -155,7 +155,7 @@ Le principal intérêt de cette installation est de pouvoir accéder à Arcane ::warning -La connexion locale d'Arcane n'a pas d'authentification multifacteur. Ne l'exposez que si vous utilisez [Pocket ID](/serveex/security/pocket-id) (voir plus bas) ou [Authentik](/serveex/advanced/authentik) pour la connexion. Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard), surtout vu le niveau d'accès qu'Arcane a sur votre hôte. +La connexion locale d'Arcane n'a pas d'authentification multifacteur. Ne l'exposez que si vous utilisez [Pocket ID](/serveex/security/pocket-id) (voir plus bas) ou [Authentik](/serveex/advanced/authentik) pour la connexion. Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard), surtout vu le niveau d'accès qu'Arcane a sur votre hôte. :: ::note @@ -194,7 +194,7 @@ Nous partons ici du principe que le nom du réseau d'Arcane est `arcane_default` ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `arcane.subdomain.conf` : +Dans les dossiers de SWAG, créez le fichier `arcane.subdomain.conf` : ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ utilisez **File Browser Quantum** pour naviguer et modifier les fichiers plutôt que des commandes dans le terminal. diff --git a/content/fr/4.stockeex/1.introduction.md b/content/fr/4.stockeex/1.introduction.md index 272098b..1da46e1 100644 --- a/content/fr/4.stockeex/1.introduction.md +++ b/content/fr/4.stockeex/1.introduction.md @@ -15,5 +15,5 @@ currently writing, come back later... -- ```
              - Image + Schéma d'une grappe RAID
              diff --git a/content/fr/5.nonsense/1.summary.md b/content/fr/5.nonsense/1.summary.md index 1511f31..af973f1 100644 --- a/content/fr/5.nonsense/1.summary.md +++ b/content/fr/5.nonsense/1.summary.md @@ -32,7 +32,7 @@ Des alertes Discord sur la disponibilité des GPU ::card --- icon: i-cbi-adguard -title: Adguard CIDRE +title: AdGuard CIDRE to: /nonsense/python/adguard-cidre ui: icon: text-[#68BC71] diff --git a/content/fr/5.nonsense/2.python/2.adguard-cidre.md b/content/fr/5.nonsense/2.python/2.adguard-cidre.md index b0cc57f..cf9c0fb 100644 --- a/content/fr/5.nonsense/2.python/2.adguard-cidre.md +++ b/content/fr/5.nonsense/2.python/2.adguard-cidre.md @@ -1,33 +1,33 @@ --- -title: Adguard CIDRE +title: AdGuard CIDRE description: Un script Python pour synchroniser automatiquement les listes CIDR d'AdGuard Home et sécuriser votre serveur DNS auto-hébergé exposé sur internet. --- :ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60} -Adguard Home est une solution merveilleuse pour filter ses requêtes DNS et ainsi se débarasser de la publicité ou des DNS des fournisseurs d'accès, ou encore réécrire des requetes. +AdGuard Home est une solution merveilleuse pour filter ses requêtes DNS et ainsi se débarasser de la publicité ou des DNS des fournisseurs d'accès, ou encore réécrire des requetes. Quand c'est en local, c'est très chouette. Mais quand on veut que tout ses appareils en profitent même à l'exterieur, on est obligé de l'exposer sur le net. Et n'importe qui peut s'en servir et saturer le petit remote à 1€ qu'on a pris pour l'heberger. -Adguard permet d'avoir des listes de clients autorisés ou bloqués. Problème, pour autoriser un client il faut son IP, et dans le cas d'un téléphone sur le réseau mobile, beh elle change régulièrement. L'idée est donc plutot de bloquer des listes générales plutot que d'autoriser des IP qui de toute façon changent régulièrement. +AdGuard permet d'avoir des listes de clients autorisés ou bloqués. Problème, pour autoriser un client il faut son IP, et dans le cas d'un téléphone sur le réseau mobile, beh elle change régulièrement. L'idée est donc plutot de bloquer des listes générales plutot que d'autoriser des IP qui de toute façon changent régulièrement. -CIDRE est un outil qui permet de synchroniser des listes de plages IP géolocalisées mises à jour régulièrement avec un pare feu. Plutot que de faire tourner CIDRE sur le remote complet avec des règles de pare feu complexes, je me suis dit qu'il fallait simplement s'arranger pour ajouter les plages IP à jour que CIDRE propose au systeme de block list d'adguard, selon les pays que l'on souhaite bloquer. +CIDRE est un outil qui permet de synchroniser des listes de plages IP géolocalisées mises à jour régulièrement avec un pare feu. Plutot que de faire tourner CIDRE sur le remote complet avec des règles de pare feu complexes, je me suis dit qu'il fallait simplement s'arranger pour ajouter les plages IP à jour que CIDRE propose au systeme de block list d'AdGuard, selon les pays que l'on souhaite bloquer. -C'est ainsi qu'est né Adguard CIDRE Sync, un conteneur qui synchronise régulièrement la block list d'Adguard avec les plages IP recensées par CIDRE à la fréquence que vous voulez. +C'est ainsi qu'est né AdGuard CIDRE Sync, un conteneur qui synchronise régulièrement la block list d'AdGuard avec les plages IP recensées par CIDRE à la fréquence que vous voulez. L'idée etant de : -- Backup le fichier de conf d'Adguard au premier lancement (le fichier jamais touché par le robot est ainsi conservé au cas où) +- Backup le fichier de conf d'AdGuard au premier lancement (le fichier jamais touché par le robot est ainsi conservé au cas où) - Télécharger la liste des pays selectionnés via une variable d'environnement - Permettre d'ajouter soi-meme des IP "à la main" dans un fichier -- Concaténer le tout, backup le fichier de conf (dernière update), et injecter la liste dans la bonne section du fichier de conf d'Adguard -- Recharger Adguard en relançant le container (accès au socket via docker socket proxy pour limiter les permissions) +- Concaténer le tout, backup le fichier de conf (dernière update), et injecter la liste dans la bonne section du fichier de conf d'AdGuard +- Recharger AdGuard en relançant le container (accès au socket via docker socket proxy pour limiter les permissions) Tout ceci de manière complètement autonome, avec une fréquence choisie en variable d'environnement dans la conf du compose. Plus d'infos directement sur le repo : -::card{title="🐋 __Adguard CIDRE Sync__"} -[Robot de synchronisation de la blocklist d'Adguard](https://git.djeex.fr/Djeex/adguard-cidre) +::card{title="🐋 __AdGuard CIDRE Sync__"} +[Robot de synchronisation de la blocklist d'AdGuard](https://git.djeex.fr/Djeex/adguard-cidre) :: diff --git a/content/fr/5.nonsense/3.bash/1.servarr-duplicates.md b/content/fr/5.nonsense/3.bash/1.servarr-duplicates.md index 70c778b..5cd5b06 100644 --- a/content/fr/5.nonsense/3.bash/1.servarr-duplicates.md +++ b/content/fr/5.nonsense/3.bash/1.servarr-duplicates.md @@ -8,7 +8,7 @@ description: Un script bash pour détecter et corriger les fichiers médias en d Six mois après avoir téléchargé des térabytes de media, je me suis rendu compte que Sonarr et Radarr les copaient dans ma biblio Plex au lieu de créer des hardlinks. C'est dû à un mécanisme contre intuitif qui est que si vous montez plusieurs dossiers dans Sonarr/Radarr, il les voit comme deux systemes de fichiers différents. Et ne peut donc pas créer de hardlinks. C'est pour cela qu'il ne faut monter qu'un seul dossier parent, qui contient tous les enfants (`downloads`, `movies`, `tvseries` dans le dossier parent `media` par exemple). -J'ai donc restructuré mes dossiers, remis à la main chaque chemin dans Qbittorrent, Plex, et autres. Il restait à trouver un moyen de détecter les doublons existants et d'automatiquement les supprimer et de créer des hardlinks à la place, pour économiser de l'espace. +J'ai donc restructuré mes dossiers, remis à la main chaque chemin dans qBittorrent, Plex, et autres. Il restait à trouver un moyen de détecter les doublons existants et d'automatiquement les supprimer et de créer des hardlinks à la place, pour économiser de l'espace. ::file-tree --- diff --git a/content/fr/5.nonsense/3.bash/3.socat-proxy.md b/content/fr/5.nonsense/3.bash/3.socat-proxy.md index f592f23..8908b15 100644 --- a/content/fr/5.nonsense/3.bash/3.socat-proxy.md +++ b/content/fr/5.nonsense/3.bash/3.socat-proxy.md @@ -23,7 +23,7 @@ Ainsi, un filtre comme Docker Socket Proxy dialogue avec Socat Proxy dans leur p En gros : -![](/img/nonsense/socat-proxy.svg) +![Schéma de Socat Proxy relayant le socket Docker entre réseaux isolés](/img/nonsense/socat-proxy.svg) Par exemple, pour Beszel cela rendrait comme ceci : diff --git a/content/fr/6.recycled/1.summary.md b/content/fr/6.recycled/1.summary.md index 849309e..5265179 100644 --- a/content/fr/6.recycled/1.summary.md +++ b/content/fr/6.recycled/1.summary.md @@ -21,7 +21,7 @@ Au fil des mois et années, certaines solutions deviennent obsolètes. Soit parc ::card --- icon: i-simple-icons-wireguard -title: Wireguard 14 +title: WireGuard 14 to: /recycled/deprecated/wireguard-14 ui: icon: text-[#88171A] @@ -55,7 +55,7 @@ L'alternative payante à Jellyfin ::card --- icon: i-cbi-qbittorrent -title: Qbittorrent pour Plex +title: qBittorrent pour Plex to: /recycled/alternatives/qbittorrent-for-plex ui: icon: text-[#2F67BA] diff --git a/content/fr/6.recycled/2.deprecated/1.wireguard-14.md b/content/fr/6.recycled/2.deprecated/1.wireguard-14.md index 5789e4e..c373291 100644 --- a/content/fr/6.recycled/2.deprecated/1.wireguard-14.md +++ b/content/fr/6.recycled/2.deprecated/1.wireguard-14.md @@ -1,5 +1,5 @@ --- -title: Wireguard 14 +title: WireGuard 14 description: Ancien guide WireGuard 14 conservé à titre archivé, voir le guide WireGuard à jour pour une installation actuelle. --- @@ -14,12 +14,12 @@ wg-easy 15 est devenu bien plus compliqué, « not so easy » dirait-on. C'est j ## Introduction L'utilisation d'un VPN permet d'accéder à distance aux ressources locales du serveur sans les exposer sur internet. C'est notamment une manière propre de sécuriser l'accès à la console SSH, plutot que d'exposer le port sur internet. C'est pouvoir se connecter à son réseau où que l'on soit, de maniere sécurisée, et de faire dialoguer des machines qui sont sur des réseaux différents. -Ici nous utiliserons [Wireguard](https://www.wireguard.com/), un serveur VPN sécurisé et très performant, à l'aide des conteneurs : +Ici nous utiliserons [WireGuard](https://www.wireguard.com/), un serveur VPN sécurisé et très performant, à l'aide des conteneurs : - [wg-easy](https://github.com/wg-easy/wg-easy) pour le serveur, qui propose une interface web très simple pour controler les connexions et télécharger les fichiers de conf (notamment par QR code pour les téléphones) -- [Wireguard](https://docs.linuxserver.io/images/docker-wireguard/?h=wireguard) pour les clients linux +- [WireGuard](https://docs.linuxserver.io/images/docker-wireguard/?h=wireguard) pour les clients Linux -Il existe aussi des clients Windows, MacOS, iOS et Android. +Il existe aussi des clients Windows, macOS, iOS et Android. Le principe est le suivant : @@ -32,7 +32,7 @@ Pour cela nous allons créer un **réseau privé virtuel**, ou VPN, c'est à dir D'autre part, vous pourrez ajouter votre téléphone, un ordinateur portable ou n'importe quel appareil au réseau pour pouvoir utiliser vos ressources depuis vos appareils quotidiens, où que vous soyiez. -![picture](/img/serveex/vpn.svg) +![Schéma d'un tunnel VPN reliant un appareil distant au réseau domestique](/img/serveex/vpn.svg) Dans cette illustration, la machine 1 est sur deux réseaux : @@ -257,8 +257,8 @@ Répétez pour chaque client ## Autres appareils -- **Téléphone :** installez Wireguard et scannez le QR code depuis l'interface web (`http://ipdevotreserveur:51821`) -- **PC :** installez le client Wireguard et importez le fichier de configuration +- **Téléphone :** installez WireGuard et scannez le QR code depuis l'interface web (`http://ipdevotreserveur:51821`) +- **PC :** installez le client WireGuard et importez le fichier de configuration ::warning @@ -268,4 +268,4 @@ __Attention :__ si un appareil client est sur le même réseau local que le serv Et voici le résultat : -![picture](/img/serveex/wireguard.svg) +![Schéma du tunnel client-serveur WireGuard](/img/serveex/wireguard.svg) diff --git a/content/fr/6.recycled/2.deprecated/2.file-browser.md b/content/fr/6.recycled/2.deprecated/2.file-browser.md index bff4f23..9e93991 100644 --- a/content/fr/6.recycled/2.deprecated/2.file-browser.md +++ b/content/fr/6.recycled/2.deprecated/2.file-browser.md @@ -58,14 +58,14 @@ Déployez le conteneur et allez sur `http://ipdevotreserveur:8010`. Et voilà ! __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: -## Exposer File Browser avec Swag +## Exposer File Browser avec SWAG ::warning -File Browser ne gère pas l'authentification multifacteur. L'exposer publiquement pourrait mettre vos systèmes en danger. Ne le faites que si vous utilisez une solution d'authentification robuste comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +File Browser ne gère pas l'authentification multifacteur. L'exposer publiquement pourrait mettre vos systèmes en danger. Ne le faites que si vous utilisez une solution d'authentification robuste comme [TinyAuth](/serveex/security/tinyauth) ou [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: -Vous voudrez peut-être accéder à File Browser à distance depuis tous vos appareils. Pour cela, nous allons l'exposer à travers Swag. +Vous voudrez peut-être accéder à File Browser à distance depuis tous vos appareils. Pour cela, nous allons l'exposer à travers SWAG. ::note @@ -103,7 +103,7 @@ Redémarrez la stack en cliquant sur « deploy » et attendez que SWAG soit comp ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `files.subdomain.conf`. +Dans les dossiers de SWAG, créez le fichier `files.subdomain.conf`. ```bash [Terminal] sudo nano /srv/docker/swag/config/nginx/proxy-confs/files.subdomain.conf diff --git a/content/fr/6.recycled/3.alternatives/1.plex.md b/content/fr/6.recycled/3.alternatives/1.plex.md index 611e7ba..a5119ba 100644 --- a/content/fr/6.recycled/3.alternatives/1.plex.md +++ b/content/fr/6.recycled/3.alternatives/1.plex.md @@ -15,7 +15,7 @@ C'est une alternative à **Jellyfin**, conservée ici pour référence. Plex n'e Avec le *Plex Pass*, vous pouvez aussi organiser et écouter votre musique à la manière de Spotify, à la différence que c'est votre contenu, hébergé et diffusé depuis votre serveur. -![picture](/img/serveex/plex.png) +![Interface web de Plex affichant une bibliothèque multimédia](/img/serveex/plex.png) Nous installerons également [Tautulli](https://docs.linuxserver.io/images/docker-tautulli/), un outil qui fournit des statistiques détaillées sur Plex. Comme toujours, nous utiliserons les images linuxserver.io quand c'est possible. @@ -150,7 +150,7 @@ Plex propose une série de films et de séries gratuits. Après avoir créé vot Allez ensuite dans la section _Accès à distance_ et choisissez manuellement un port (nous prendrons `1234`). Mieux vaut ne pas utiliser le port par défaut. -![picture](/img/serveex/plex-port.png) +![Réglages d'accès distant de Plex avec un port choisi manuellement](/img/serveex/plex-port.png) - Sur votre box, redirigez le port TCP `1234` vers le port `32400` de l'IP de votre serveur avec les [règles NAT](/general/networking/nat). - Une fois fait, retournez dans Plex pour vérifier que l'accès à distance fonctionne. @@ -173,7 +173,7 @@ Ajoutez simplement vos médias dans `/media/movies` et `/media/tvseries` sur vot Si vos médias sont stockés sur un disque réseau (un NAS ou un disque dur externe accessible par le réseau), reportez-vous au **guide de montage Samba** pour que Plex puisse y accéder. :: -## Exposer Tautulli avec Swag +## Exposer Tautulli avec SWAG Vous n'avez pas besoin d'exposer Plex, il est accessible via votre compte Plex sur plex.tv. En revanche, vous voudrez peut-être exposer Tautulli pour consulter vos statistiques depuis une simple URL quand vous n'êtes pas chez vous. diff --git a/content/fr/6.recycled/3.alternatives/2.qbittorrent for plex.md b/content/fr/6.recycled/3.alternatives/2.qbittorrent-for-plex.md similarity index 91% rename from content/fr/6.recycled/3.alternatives/2.qbittorrent for plex.md rename to content/fr/6.recycled/3.alternatives/2.qbittorrent-for-plex.md index 6dbb6e2..7077d1d 100644 --- a/content/fr/6.recycled/3.alternatives/2.qbittorrent for plex.md +++ b/content/fr/6.recycled/3.alternatives/2.qbittorrent-for-plex.md @@ -1,5 +1,5 @@ --- -title: Qbittorrent pour Plex +title: qBittorrent pour Plex description: Installer qBittorrent avec Gluetun et ProtonVPN pour télécharger des torrents de manière sécurisée derrière un VPN sur votre serveur auto-hébergé. --- @@ -8,22 +8,22 @@ description: Installer qBittorrent avec Gluetun et ProtonVPN pour télécharger ::note{to="/serveex/media/qbittorrent"} -C'est l'installation de la seedbox associée à Plex plutôt qu'à Jellyfin, conservée ici pour référence. Voir **Qbittorrent** pour la même installation associée à Jellyfin, l'alternative recommandée puisque Plex n'est pas entièrement auto-hébergé (son propre relais, un compte obligatoire) et enferme des fonctions derrière le paywall du Plex Pass. +C'est l'installation de la seedbox associée à Plex plutôt qu'à Jellyfin, conservée ici pour référence. Voir **qBittorrent** pour la même installation associée à Jellyfin, l'alternative recommandée puisque Plex n'est pas entièrement auto-hébergé (son propre relais, un compte obligatoire) et enferme des fonctions derrière le paywall du Plex Pass. :: -![Picture](/img/serveex/qbit-vue.jpeg) +![Interface web de VueTorrent affichant des téléchargements actifs](/img/serveex/qbit-vue.jpeg) Afin de télécharger vos media favoris en toute sécurité, nous allons monter un système à base de : - [Qbittorent](https://github.com/linuxserver/docker-qbittorrent) comme logiciel de téléchargement bittorent - [Proton VPN Plus](https://protonvpn.com/torrenting), VPN pour sécuriser vos échanges, auquel vous devez souscrire (il y a de nombreux codes promo) pour accéder au protocole Bittorent, mais vous pouvez également en choisir un autre, à condition qu'il propose le protocole bittorent. - [Gluetun](https://github.com/qdm12/gluetun) -- [Qbittorrent port update](https://codeberg.org/TechnoSam/qbittorrent-gluetun-port-update) pour mettre automatiquement à jour le port de votre VPN (qui change régulièrement). +- [qBittorrent port update](https://codeberg.org/TechnoSam/qbittorrent-gluetun-port-update) pour mettre automatiquement à jour le port de votre VPN (qui change régulièrement). - Et le mode [vuetorrent](https://github.com/gabe565/linuxserver-mod-vuetorrent) pour une interface moderne et intuitive. Nous monterons ici le système ci-dessous : -![Picture](/img/serveex/qbit.svg) +![Schéma du trafic de qBittorrent passant par le tunnel VPN Gluetun](/img/serveex/qbit.svg) ## Configuration @@ -39,7 +39,7 @@ tree: - gluetun/ - compose.yaml - .env - - "media # relié à Plex et Qbittorrent": + - "media # relié à Plex et qBittorrent": - "downloads/ # téléchargements génériques, choisis dans les réglages" - "movies/ # utilisé pour télécharger les films" - "tvseries/ # utilisé pour télécharger les séries" @@ -127,7 +127,7 @@ services: ### Configurer la synchronisation du port -Avant de renseigner le `.env` dans Dockge, configurons la mise à jour du port de téléchargement. Proton et la plupart des VPN font tourner le port de redirection, qui doit être communiqué à Qbittorrent. +Avant de renseigner le `.env` dans Dockge, configurons la mise à jour du port de téléchargement. Proton et la plupart des VPN font tourner le port de redirection, qui doit être communiqué à qBittorrent. Nous avons ajouté le mod `ghcr.io/t-anc/gsp-qbittorent-gluetun-sync-port-mod` au conteneur. @@ -186,8 +186,8 @@ Détail : | `UI_PORT` | Port d'accès à l'interface web | `5695` | | `PR_KEY` | Clé privée fournie par Proton | `buKsjNHLyzKMM1qYnzOy4s7SHfly` | | `GSP_KEY` | Clé générée pour la mise à jour du port | `MnBa47MeVmk7xiv` | -| `ID` | Identifiant de connexion à l'interface Qbittorrent | `user` | -| `PW` | Mot de passe de l'interface Qbittorrent | `password` | +| `ID` | Identifiant de connexion à l'interface qBittorrent | `user` | +| `PW` | Mot de passe de l'interface qBittorrent | `password` | ### Terminé ! :: @@ -218,7 +218,7 @@ Changez votre identifiant et votre mot de passe dans les réglages « webui ». ### Terminé ! :: -C'est terminé ! Dans les réglages de Qbittorrent, section « Téléchargements », définissez `/media/downloads` comme dossier par défaut. +C'est terminé ! Dans les réglages de qBittorrent, section « Téléchargements », définissez `/media/downloads` comme dossier par défaut. Lors de l'ajout d'un téléchargement, pensez à choisir le bon dossier pour que Plex se synchronise correctement (`/media/movies` ou `/media/tvseries`). Vous pouvez aussi automatiser cela avec des catégories et des dossiers. @@ -226,10 +226,10 @@ Lors de l'ajout d'un téléchargement, pensez à choisir le bon dossier pour que ::warning -Qbittorrent ne gère pas l'authentification multifacteur. L'exposer sur internet peut mettre votre système en danger. Ne le faites que si vous utilisez du MFA via [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [Wireguard](/serveex/core/wireguard). +qBittorrent ne gère pas l'authentification multifacteur. L'exposer sur internet peut mettre votre système en danger. Ne le faites que si vous utilisez du MFA via [Authentik](/serveex/advanced/authentik/). Sinon, ne l'exposez pas avec SWAG. Utilisez plutôt un VPN comme [WireGuard](/serveex/core/wireguard). :: -Pour lancer des téléchargements depuis l'extérieur, sans VPN, vous pouvez exposer l'interface web de Qbittorrent. +Pour lancer des téléchargements depuis l'extérieur, sans VPN, vous pouvez exposer l'interface web de qBittorrent. ::note @@ -339,8 +339,8 @@ Appuyez sur :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"} pour enregistrer, et ### Terminé ! :: -Attendez quelques minutes, puis allez sur `https://seedbox.mondomaine.fr`. Vous devriez arriver sur l'interface de Qbittorrent. +Attendez quelques minutes, puis allez sur `https://seedbox.mondomaine.fr`. Vous devriez arriver sur l'interface de qBittorrent. Et voilà ! Vous avez maintenant un media center prêt à l'emploi. -![Picture](/img/serveex/seed.svg) +![Schéma complet de la seedbox, de qBittorrent à SWAG](/img/serveex/seed.svg) diff --git a/content/fr/6.recycled/3.alternatives/3.servarr for plex.md b/content/fr/6.recycled/3.alternatives/3.servarr-for-plex.md similarity index 97% rename from content/fr/6.recycled/3.alternatives/3.servarr for plex.md rename to content/fr/6.recycled/3.alternatives/3.servarr-for-plex.md index b8966e5..734d7af 100644 --- a/content/fr/6.recycled/3.alternatives/3.servarr for plex.md +++ b/content/fr/6.recycled/3.alternatives/3.servarr-for-plex.md @@ -57,7 +57,7 @@ tree: ::warning __Attention :__ respectez bien cette structure de fichiers, en particulier le dossier `media`. Ce dossier doit être monté **exactement de la même façon** dans le fichier compose de _Qbittorrent_ (`/votre/chemin/media:/media`) et dans les applications _arr_. -Sinon, les applications _arr_ risquent de ne pas reconnaître le chemin fourni par Qbittorrent et ne créeront pas de _hardlinks_. +Sinon, les applications _arr_ risquent de ne pas reconnaître le chemin fourni par qBittorrent et ne créeront pas de _hardlinks_. Sans hardlinks, les applications _arr_ copieront les fichiers, ce qui **doublera l'espace utilisé** sur votre stockage. :: @@ -205,7 +205,7 @@ MEDIA_PATH= |----------------|-------------------------------------------------------------------------------------------------|-------------| | `PUID` | À renseigner avec vos informations utilisateur (à vérifier avec `id votreutilisateur`) | `1000` | | `PGID` | Idem | `1000` | -| `MEDIA_PATH` | Chemin de votre dossier média, ici `/media`. Il doit correspondre à celui utilisé par Qbittorrent. | `/media` | +| `MEDIA_PATH` | Chemin de votre dossier média, ici `/media`. Il doit correspondre à celui utilisé par qBittorrent. | `/media` | Déployez la stack. @@ -233,7 +233,7 @@ Créez un compte et choisissez *forms login*. ::warning -__Attention :__ si vous avez déjà des films dans `movies` provenant de Qbittorrent, ne laissez pas Radarr les ajouter. Radarr pourrait les modifier, ce qui interromprait le seed dans Qbittorrent. +__Attention :__ si vous avez déjà des films dans `movies` provenant de qBittorrent, ne laissez pas Radarr les ajouter. Radarr pourrait les modifier, ce qui interromprait le seed dans qBittorrent. :: #### Configurer les profils @@ -242,12 +242,12 @@ Allez dans *Settings > Profiles*. Ce sont vos profils de qualité par défaut. Q ![profiles_radarr](/img/serveex/radarr1.png) -#### Ajouter Qbittorrent +#### Ajouter qBittorrent -Dans *Settings > Download Clients*, ajoutez Qbittorrent. +Dans *Settings > Download Clients*, ajoutez qBittorrent. - Utilisez l'IP de votre serveur comme *Host* et le port `5695` si vous suivez ce guide. -- Renseignez vos *Username* et *Password* Qbittorrent. +- Renseignez vos *Username* et *Password* qBittorrent. - Cliquez sur *Test*. - Si le test réussit, cliquez sur *Save*. diff --git a/content/fr/6.recycled/3.alternatives/4.gitea.md b/content/fr/6.recycled/3.alternatives/4.gitea.md index bad6fb8..96ec7cd 100644 --- a/content/fr/6.recycled/3.alternatives/4.gitea.md +++ b/content/fr/6.recycled/3.alternatives/4.gitea.md @@ -75,8 +75,8 @@ Déployez le conteneur et allez sur `http://ipdevotreserveur:3333`. Votre instan __Si ça ne marche pas :__ vérifiez les règles de votre pare-feu. :: -## Exposer Gitea avec Swag -L'intérêt de cette installation est de pouvoir y accéder à distance depuis n'importe lequel de vos appareils. Pour cela, nous allons exposer Gitea à travers Swag. +## Exposer Gitea avec SWAG +L'intérêt de cette installation est de pouvoir y accéder à distance depuis n'importe lequel de vos appareils. Pour cela, nous allons exposer Gitea à travers SWAG. ::note @@ -114,7 +114,7 @@ Redéployez la stack en cliquant sur « Deploy » et attendez que SWAG soit plei ### Créer le fichier subdomain.conf -Dans les dossiers de Swag, créez le fichier `gitea.subdomain.conf`. +Dans les dossiers de SWAG, créez le fichier `gitea.subdomain.conf`. ::tip{icon="" to="/serveex/files/file-browser-quantum"} ✨ __Astuce :__ vous pouvez utiliser **File Browser** pour naviguer et modifier vos fichiers plutôt que des commandes dans le terminal. diff --git a/content/fr/index.md b/content/fr/index.md index fc48837..eef8194 100644 --- a/content/fr/index.md +++ b/content/fr/index.md @@ -17,7 +17,7 @@ seo: ::::: :::::div{class="my-6 pt-[25px] pb-[25px]"} -![](/img/global/docudjeex-home.svg){.w-full} +![Illustration de la page d'accueil de Docudjeex](/img/global/docudjeex-home.svg){.w-full} ::::: :::::div{class="flex flex-col sm:flex-row sm:items-center gap-3"} -- 2.54.0 From 2fa42ad3aaef3d421f2530f04db1b25dead9a5a1 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 14:39:59 +0200 Subject: [PATCH 18/20] Fix leftover EN anchor and dead self-referencing anchor in authentik.md missed by the earlier anchor pass --- content/en/3.serveex/91.advanced/1.authentik.md | 2 +- content/fr/3.serveex/91.advanced/1.authentik.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/content/en/3.serveex/91.advanced/1.authentik.md b/content/en/3.serveex/91.advanced/1.authentik.md index e76a903..dbe6786 100644 --- a/content/en/3.serveex/91.advanced/1.authentik.md +++ b/content/en/3.serveex/91.advanced/1.authentik.md @@ -428,7 +428,7 @@ Prerequisites: - If the app has no native integration, use a compatible reverse proxy. We will use [SWAG](/serveex/core/swag) here. :: -This container will forward requests to your main [Authentik](/serveex/advanced/authentik#authentik) instance over the internet (or your local network). The server will perform checks and respond to the Outpost, which will allow or block access accordingly. +This container will forward requests to your main [Authentik](/serveex/advanced/authentik) instance over the internet (or your local network). The server will perform checks and respond to the Outpost, which will allow or block access accordingly. ![auth-outpost](/img/serveex/auth-outpost.svg) diff --git a/content/fr/3.serveex/91.advanced/1.authentik.md b/content/fr/3.serveex/91.advanced/1.authentik.md index 61de9a0..405a665 100644 --- a/content/fr/3.serveex/91.advanced/1.authentik.md +++ b/content/fr/3.serveex/91.advanced/1.authentik.md @@ -418,7 +418,7 @@ Votre nouvelle architecture ressemble à ceci : ![Schéma de l'architecture obtenue avec Authentik protégeant les applications via SWAG](/img/serveex/authentik.svg) ## Protéger un service sur un serveur distant -Pour une [application native](/serveex/advanced/authentik/#protecting-a-native-app) (via OAuth 2.0 ou autre), rien ne change. +Pour une [application native](/serveex/advanced/authentik/#protéger-une-app-native) (via OAuth 2.0 ou autre), rien ne change. Pour une application non native derrière un reverse proxy, vous devez déployer un __Outpost__. Un Outpost est un conteneur qui fait office de proxy local. C'est la cible des requêtes d'authentification de votre application, et le seul autorisé à communiquer avec votre API Authentik. @@ -429,14 +429,14 @@ Prérequis : - Si l'application n'a pas d'intégration native, utiliser un reverse proxy compatible. Nous utiliserons [SWAG](/serveex/core/swag) ici. :: -Ce conteneur transmettra les requêtes à votre instance [Authentik](/serveex/advanced/authentik#authentik) principale via internet (ou votre réseau local). Le serveur effectuera les vérifications et répondra à l'Outpost, qui autorisera ou bloquera l'accès en conséquence. +Ce conteneur transmettra les requêtes à votre instance [Authentik](/serveex/advanced/authentik) principale via internet (ou votre réseau local). Le serveur effectuera les vérifications et répondra à l'Outpost, qui autorisera ou bloquera l'accès en conséquence. ![auth-outpost](/img/serveex/auth-outpost.svg) ::steps{level="3"} ### Configuration d'Authentik -Créez vos [providers et applications](/serveex/advanced/authentik/#protecting-a-native-app) comme montré plus haut. +Créez vos [providers et applications](/serveex/advanced/authentik/#protéger-une-app-native) comme montré plus haut. Puis, dans le panneau d'administration, allez dans _Applications > Outposts_, et créez un nouvel outpost. @@ -620,7 +620,7 @@ Enregistrez avec :kbd{value="Ctrl+O"}, puis :kbd{value="Enter"}, et quittez avec ### Terminé ! :: -Configurez ensuite les applications à protéger comme vous l'avez fait sur votre serveur principal, qu'elles soient [natives](/serveex/advanced/authentik/#protecting-a-native-app) ou protégées via [reverse proxy](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). +Configurez ensuite les applications à protéger comme vous l'avez fait sur votre serveur principal, qu'elles soient [natives](/serveex/advanced/authentik/#protéger-une-app-native) ou protégées via [reverse proxy](/serveex/advanced/authentik#protéger-une-app-par-reverse-proxy). ## Migrer une base de données Authentik -- 2.54.0 From be4b79026b703f9e82fbe88405a1afca5c1f3ed2 Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 14:44:01 +0200 Subject: [PATCH 19/20] Fix GUID/PGID mismatch in 7 more app guides missed by the earlier pass --- content/en/3.serveex/4.monitoring/3.speedtest-tracker.md | 8 ++++---- content/en/3.serveex/5.media/1.jellyfin.md | 6 +++--- content/en/3.serveex/5.media/2.qbittorrent.md | 6 +++--- content/en/3.serveex/6.cloud/2.nextcloud.md | 6 +++--- content/en/3.serveex/8.development/1.code-server.md | 6 +++--- content/en/6.recycled/3.alternatives/1.plex.md | 8 ++++---- .../6.recycled/3.alternatives/2.qbittorrent-for-plex.md | 6 +++--- content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md | 8 ++++---- content/fr/3.serveex/5.media/1.jellyfin.md | 6 +++--- content/fr/3.serveex/5.media/2.qbittorrent.md | 6 +++--- content/fr/3.serveex/6.cloud/2.nextcloud.md | 6 +++--- content/fr/3.serveex/8.development/1.code-server.md | 6 +++--- content/fr/6.recycled/3.alternatives/1.plex.md | 8 ++++---- .../6.recycled/3.alternatives/2.qbittorrent-for-plex.md | 6 +++--- 14 files changed, 46 insertions(+), 46 deletions(-) diff --git a/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md b/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md index 7e957b8..4396510 100644 --- a/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md +++ b/content/en/3.serveex/4.monitoring/3.speedtest-tracker.md @@ -56,7 +56,7 @@ services: - ${PORT}:80 environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Europe/Paris - APP_KEY=${API_KEY} - DB_CONNECTION=sqlite @@ -67,19 +67,19 @@ services: ### Set your environment variables -Find your `PUID` and `GUID` by running the following command: +Find your `PUID` and `PGID` by running the following command: ```bash [Terminal] id yourusername ``` -In the `.env` file, set the variable `API_KEY` with the key you generated and add a cron-style test schedule, as well as your `PUID` and `GUID`, for example: +In the `.env` file, set the variable `API_KEY` with the key you generated and add a cron-style test schedule, as well as your `PUID` and `PGID`, for example: ```properties [.env] SCHEDULE=15 */6 * * * # every 6 hours API_KEY=base64:zihejehkj8_nzhY/OjeieR= # your key PUID=1000 -GUID=1000 +PGID=1000 PORT=3225 # port to access the web UI ``` diff --git a/content/en/3.serveex/5.media/1.jellyfin.md b/content/en/3.serveex/5.media/1.jellyfin.md index 9989124..e34e36a 100644 --- a/content/en/3.serveex/5.media/1.jellyfin.md +++ b/content/en/3.serveex/5.media/1.jellyfin.md @@ -59,7 +59,7 @@ services: container_name: jellyfin environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Europe/Paris volumes: - /srv/docker/jellyfin/config:/config @@ -86,7 +86,7 @@ services: ### Set your environment variables -Find your PUID and GUID by running: +Find your PUID and PGID by running: ```bash [Terminal] id username @@ -96,7 +96,7 @@ Fill in your `.env` file with the retrieved values, for example: ```properties [.env] PUID=1000 -GUID=1000 +PGID=1000 ``` Deploy the stack. The local interface is available at `http://yourserverip:8096`. diff --git a/content/en/3.serveex/5.media/2.qbittorrent.md b/content/en/3.serveex/5.media/2.qbittorrent.md index 6034f51..f78a697 100644 --- a/content/en/3.serveex/5.media/2.qbittorrent.md +++ b/content/en/3.serveex/5.media/2.qbittorrent.md @@ -67,7 +67,7 @@ services: - DOCKER_MODS=ghcr.io/gabe565/linuxserver-mod-vuetorrent|ghcr.io/t-anc/gsp-qbittorent-gluetun-sync-port-mod:main - TZ=Europe/Paris - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - WEBUI_PORT=${UI_PORT} - GSP_GTN_API_KEY=${GSP_KEY} - GSP_QBT_USERNAME=${ID} @@ -164,7 +164,7 @@ In Dockge, fill in the variables in `.env`: ```properties [.env] PUID= -GUID= +PGID= UI_PORT= PR_KEY= GSP_KEY= # the key you generated and entered in config.toml @@ -177,7 +177,7 @@ Detailed info: | Variable | Description | Example | |------------|-------------|---------| | `PUID` | User ID (`id yourusername`) | `1000` | -| `GUID` | Group ID (`id yourusername`) | `1000` | +| `PGID` | Group ID (`id yourusername`) | `1000` | | `UI_PORT` | Port for accessing the web UI | `5695` | | `PR_KEY` | Private key from Proton | `buKsjNHLyzKMM1qYnzOy4s7SHfly` | | `GSP_KEY` | Key you generated for port update | `MnBa47MeVmk7xiv` | diff --git a/content/en/3.serveex/6.cloud/2.nextcloud.md b/content/en/3.serveex/6.cloud/2.nextcloud.md index 4359b8f..f330f3a 100644 --- a/content/en/3.serveex/6.cloud/2.nextcloud.md +++ b/content/en/3.serveex/6.cloud/2.nextcloud.md @@ -43,7 +43,7 @@ services: container_name: nextcloud environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Etc/UTC volumes: - /srv/docker/nextcloud/config:/config @@ -60,7 +60,7 @@ If you’re using a NAS or network-shared drive via **Samba**, replace `/srv/doc ### Set your environment variables -Find your `PUID` and `GUID` by running the following command: +Find your `PUID` and `PGID` by running the following command: ```bash [Terminal] id username @@ -70,7 +70,7 @@ Then fill out the `.env` file with your preferred port and the values found abov ```properties [.env] PUID=1000 -GUID=1000 +PGID=1000 PORT=4545 ``` diff --git a/content/en/3.serveex/8.development/1.code-server.md b/content/en/3.serveex/8.development/1.code-server.md index e1bd7b6..7f68dc7 100644 --- a/content/en/3.serveex/8.development/1.code-server.md +++ b/content/en/3.serveex/8.development/1.code-server.md @@ -43,7 +43,7 @@ services: container_name: code-server environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Etc/UTC - HASHED_PASSWORD=${PW} volumes: @@ -76,7 +76,7 @@ Choose a password and generate its hash: echo -n "yourpassword" | npx argon2-cli -e ``` -Save the result carefully. Find your PUID and GUID with: +Save the result carefully. Find your PUID and PGID with: ```bash [Terminal] id yourusername @@ -87,7 +87,7 @@ Fill in the `.env` file with the values you found, for example: ```properties [.env] PW='$argon2i$v=19$m=4096,t=3,p=1$wST5QhBgk2lu1ih4DMuxvg$LS1alrVdIWtvZHwnzCM1DUGg+5DTO3Dt1d5v9XtLws4' PUID=1000 -GUID=1000 +PGID=1000 ``` ::warning diff --git a/content/en/6.recycled/3.alternatives/1.plex.md b/content/en/6.recycled/3.alternatives/1.plex.md index 6722a51..fe5c4af 100644 --- a/content/en/6.recycled/3.alternatives/1.plex.md +++ b/content/en/6.recycled/3.alternatives/1.plex.md @@ -72,7 +72,7 @@ services: network_mode: host environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Europe/Paris - VERSION=docker volumes: @@ -90,7 +90,7 @@ services: container_name: tautulli environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Europe/Paris volumes: - /srv/docker/tautulli/config:/config @@ -119,7 +119,7 @@ services: ### Set your environment variables -Find your PUID and GUID by running: +Find your PUID and PGID by running: ```bash [Terminal] id username @@ -129,7 +129,7 @@ Fill in your `.env` file with the retrieved values, for example: ```properties [.env] PUID=1000 -GUID=1000 +PGID=1000 ``` Deploy the stack. diff --git a/content/en/6.recycled/3.alternatives/2.qbittorrent-for-plex.md b/content/en/6.recycled/3.alternatives/2.qbittorrent-for-plex.md index bd0e2c5..fea14bc 100644 --- a/content/en/6.recycled/3.alternatives/2.qbittorrent-for-plex.md +++ b/content/en/6.recycled/3.alternatives/2.qbittorrent-for-plex.md @@ -72,7 +72,7 @@ services: - DOCKER_MODS=ghcr.io/gabe565/linuxserver-mod-vuetorrent|ghcr.io/t-anc/gsp-qbittorent-gluetun-sync-port-mod:main - TZ=Europe/Paris - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - WEBUI_PORT=${UI_PORT} - GSP_GTN_API_KEY=${GSP_KEY} - GSP_QBT_USERNAME=${ID} @@ -169,7 +169,7 @@ In Dockge, fill in the variables in `.env`: ```properties [.env] PUID= -GUID= +PGID= UI_PORT= PR_KEY= GSP_KEY= # the key you generated and entered in config.toml @@ -182,7 +182,7 @@ Detailed info: | Variable | Description | Example | |------------|-------------|---------| | `PUID` | User ID (`id yourusername`) | `1000` | -| `GUID` | Group ID (`id yourusername`) | `1000` | +| `PGID` | Group ID (`id yourusername`) | `1000` | | `UI_PORT` | Port for accessing the web UI | `5695` | | `PR_KEY` | Private key from Proton | `buKsjNHLyzKMM1qYnzOy4s7SHfly` | | `GSP_KEY` | Key you generated for port update | `MnBa47MeVmk7xiv` | diff --git a/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md b/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md index c9388a2..41da074 100644 --- a/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md +++ b/content/fr/3.serveex/4.monitoring/3.speedtest-tracker.md @@ -56,7 +56,7 @@ services: - ${PORT}:80 environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Europe/Paris - APP_KEY=${API_KEY} - DB_CONNECTION=sqlite @@ -67,19 +67,19 @@ services: ### Renseigner vos variables d'environnement -Trouvez vos `PUID` et `GUID` avec la commande suivante : +Trouvez vos `PUID` et `PGID` avec la commande suivante : ```bash [Terminal] id votreutilisateur ``` -Dans le fichier `.env`, renseignez la variable `API_KEY` avec la clé générée et ajoutez une planification des tests au format cron, ainsi que vos `PUID` et `GUID`, par exemple : +Dans le fichier `.env`, renseignez la variable `API_KEY` avec la clé générée et ajoutez une planification des tests au format cron, ainsi que vos `PUID` et `PGID`, par exemple : ```properties [.env] SCHEDULE=15 */6 * * * # toutes les 6 heures API_KEY=base64:zihejehkj8_nzhY/OjeieR= # votre clé PUID=1000 -GUID=1000 +PGID=1000 PORT=3225 # port d'accès à l'interface web ``` diff --git a/content/fr/3.serveex/5.media/1.jellyfin.md b/content/fr/3.serveex/5.media/1.jellyfin.md index ea9f694..d1251c3 100644 --- a/content/fr/3.serveex/5.media/1.jellyfin.md +++ b/content/fr/3.serveex/5.media/1.jellyfin.md @@ -59,7 +59,7 @@ services: container_name: jellyfin environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Europe/Paris volumes: - /srv/docker/jellyfin/config:/config @@ -86,7 +86,7 @@ services: ### Renseigner vos variables d'environnement -Trouvez vos PUID et GUID en lançant : +Trouvez vos PUID et PGID en lançant : ```bash [Terminal] id utilisateur @@ -96,7 +96,7 @@ Remplissez votre fichier `.env` avec les valeurs récupérées, par exemple : ```properties [.env] PUID=1000 -GUID=1000 +PGID=1000 ``` Déployez la stack. L'interface locale est disponible sur `http://ipdevotreserveur:8096`. diff --git a/content/fr/3.serveex/5.media/2.qbittorrent.md b/content/fr/3.serveex/5.media/2.qbittorrent.md index c378bf8..885ef42 100644 --- a/content/fr/3.serveex/5.media/2.qbittorrent.md +++ b/content/fr/3.serveex/5.media/2.qbittorrent.md @@ -67,7 +67,7 @@ services: - DOCKER_MODS=ghcr.io/gabe565/linuxserver-mod-vuetorrent|ghcr.io/t-anc/gsp-qbittorent-gluetun-sync-port-mod:main - TZ=Europe/Paris - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - WEBUI_PORT=${UI_PORT} - GSP_GTN_API_KEY=${GSP_KEY} - GSP_QBT_USERNAME=${ID} @@ -164,7 +164,7 @@ Dans Dockge, renseignez les variables du `.env` : ```properties [.env] PUID= -GUID= +PGID= UI_PORT= PR_KEY= GSP_KEY= # la clé générée et saisie dans config.toml @@ -177,7 +177,7 @@ Détail : | Variable | Description | Exemple | |------------|-------------|---------| | `PUID` | ID utilisateur (`id votreutilisateur`) | `1000` | -| `GUID` | ID de groupe (`id votreutilisateur`) | `1000` | +| `PGID` | ID de groupe (`id votreutilisateur`) | `1000` | | `UI_PORT` | Port d'accès à l'interface web | `5695` | | `PR_KEY` | Clé privée fournie par Proton | `buKsjNHLyzKMM1qYnzOy4s7SHfly` | | `GSP_KEY` | Clé générée pour la mise à jour du port | `MnBa47MeVmk7xiv` | diff --git a/content/fr/3.serveex/6.cloud/2.nextcloud.md b/content/fr/3.serveex/6.cloud/2.nextcloud.md index 173b98f..a2eaa0d 100644 --- a/content/fr/3.serveex/6.cloud/2.nextcloud.md +++ b/content/fr/3.serveex/6.cloud/2.nextcloud.md @@ -43,7 +43,7 @@ services: container_name: nextcloud environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Etc/UTC volumes: - /srv/docker/nextcloud/config:/config @@ -60,7 +60,7 @@ Si vous utilisez un NAS ou un disque partagé sur le réseau via **Samba**, remp ### Renseigner vos variables d'environnement -Trouvez vos `PUID` et `GUID` avec la commande suivante : +Trouvez vos `PUID` et `PGID` avec la commande suivante : ```bash [Terminal] id utilisateur @@ -70,7 +70,7 @@ Remplissez ensuite le fichier `.env` avec le port de votre choix et les valeurs ```properties [.env] PUID=1000 -GUID=1000 +PGID=1000 PORT=4545 ``` diff --git a/content/fr/3.serveex/8.development/1.code-server.md b/content/fr/3.serveex/8.development/1.code-server.md index 8436387..6cfd6bb 100644 --- a/content/fr/3.serveex/8.development/1.code-server.md +++ b/content/fr/3.serveex/8.development/1.code-server.md @@ -43,7 +43,7 @@ services: container_name: code-server environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Etc/UTC - HASHED_PASSWORD=${PW} volumes: @@ -76,7 +76,7 @@ Choisissez un mot de passe et générez son hash : echo -n "votremotdepasse" | npx argon2-cli -e ``` -Conservez précieusement le résultat. Trouvez vos PUID et GUID avec : +Conservez précieusement le résultat. Trouvez vos PUID et PGID avec : ```bash [Terminal] id votreutilisateur @@ -87,7 +87,7 @@ Remplissez le fichier `.env` avec les valeurs trouvées, par exemple : ```properties [.env] PW='$argon2i$v=19$m=4096,t=3,p=1$wST5QhBgk2lu1ih4DMuxvg$LS1alrVdIWtvZHwnzCM1DUGg+5DTO3Dt1d5v9XtLws4' PUID=1000 -GUID=1000 +PGID=1000 ``` ::warning diff --git a/content/fr/6.recycled/3.alternatives/1.plex.md b/content/fr/6.recycled/3.alternatives/1.plex.md index a5119ba..150276c 100644 --- a/content/fr/6.recycled/3.alternatives/1.plex.md +++ b/content/fr/6.recycled/3.alternatives/1.plex.md @@ -72,7 +72,7 @@ services: network_mode: host environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Europe/Paris - VERSION=docker volumes: @@ -90,7 +90,7 @@ services: container_name: tautulli environment: - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - TZ=Europe/Paris volumes: - /srv/docker/tautulli/config:/config @@ -119,7 +119,7 @@ services: ### Renseigner vos variables d'environnement -Trouvez vos PUID et GUID en lançant : +Trouvez vos PUID et PGID en lançant : ```bash [Terminal] id utilisateur @@ -129,7 +129,7 @@ Remplissez votre fichier `.env` avec les valeurs récupérées, par exemple : ```properties [.env] PUID=1000 -GUID=1000 +PGID=1000 ``` Déployez la stack. diff --git a/content/fr/6.recycled/3.alternatives/2.qbittorrent-for-plex.md b/content/fr/6.recycled/3.alternatives/2.qbittorrent-for-plex.md index 7077d1d..d8c801b 100644 --- a/content/fr/6.recycled/3.alternatives/2.qbittorrent-for-plex.md +++ b/content/fr/6.recycled/3.alternatives/2.qbittorrent-for-plex.md @@ -72,7 +72,7 @@ services: - DOCKER_MODS=ghcr.io/gabe565/linuxserver-mod-vuetorrent|ghcr.io/t-anc/gsp-qbittorent-gluetun-sync-port-mod:main - TZ=Europe/Paris - PUID=${PUID} - - PGID=${GUID} + - PGID=${PGID} - WEBUI_PORT=${UI_PORT} - GSP_GTN_API_KEY=${GSP_KEY} - GSP_QBT_USERNAME=${ID} @@ -169,7 +169,7 @@ Dans Dockge, renseignez les variables du `.env` : ```properties [.env] PUID= -GUID= +PGID= UI_PORT= PR_KEY= GSP_KEY= # la clé générée et saisie dans config.toml @@ -182,7 +182,7 @@ Détail : | Variable | Description | Exemple | |------------|-------------|---------| | `PUID` | ID utilisateur (`id votreutilisateur`) | `1000` | -| `GUID` | ID de groupe (`id votreutilisateur`) | `1000` | +| `PGID` | ID de groupe (`id votreutilisateur`) | `1000` | | `UI_PORT` | Port d'accès à l'interface web | `5695` | | `PR_KEY` | Clé privée fournie par Proton | `buKsjNHLyzKMM1qYnzOy4s7SHfly` | | `GSP_KEY` | Clé générée pour la mise à jour du port | `MnBa47MeVmk7xiv` | -- 2.54.0 From 991b0c356ec114235f82021f1f42c146a19fd79c Mon Sep 17 00:00:00 2001 From: Djeex Date: Mon, 7 Sep 2026 14:44:09 +0200 Subject: [PATCH 20/20] Narrow uptime-kuma.md's own TinyAuth public-paths regex, matching the tinyauth.md fix --- content/en/3.serveex/4.monitoring/1.uptime-kuma.md | 4 ++-- content/fr/3.serveex/4.monitoring/1.uptime-kuma.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/3.serveex/4.monitoring/1.uptime-kuma.md b/content/en/3.serveex/4.monitoring/1.uptime-kuma.md index 3e62a6e..34ba014 100644 --- a/content/en/3.serveex/4.monitoring/1.uptime-kuma.md +++ b/content/en/3.serveex/4.monitoring/1.uptime-kuma.md @@ -192,7 +192,7 @@ sudo nano /srv/docker/swag/config/nginx/proxy-confs/stats.subdomain.conf ### Add the forward-auth check and public paths -Replace the file's content with the following. The `location ~ ^/(...)` block matches Uptime-Kuma's public status page and its assets, and is served directly, without ever reaching the `auth_request` check in `location /`: +Replace the file's content with the following. The `location ~ ^/(...)` block matches Uptime-Kuma's public status page and its assets, and is served directly, without ever reaching the `auth_request` check in `location /`. Only `api/status-page` is left public, not all of `/api`, since the rest of Uptime-Kuma's API is meant to stay behind authentication; `/metrics` (Uptime-Kuma's Prometheus endpoint) is left out of the regex entirely for the same reason: ```nginx [stats.subdomain.conf]{9-16,32-33} server { @@ -203,7 +203,7 @@ server { include /config/nginx/ssl.conf; - location ~ ^/(status|assets|icon\.svg|api|upload|metrics) { + location ~ ^/(status|assets|icon\.svg|api/status-page|upload) { include /config/nginx/proxy.conf; include /config/nginx/resolver.conf; set $upstream_app uptime-kuma; diff --git a/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md b/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md index 8ddc77d..d946a84 100644 --- a/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md +++ b/content/fr/3.serveex/4.monitoring/1.uptime-kuma.md @@ -192,7 +192,7 @@ sudo nano /srv/docker/swag/config/nginx/proxy-confs/stats.subdomain.conf ### Ajouter la vérification forward-auth et les chemins publics -Remplacez le contenu du fichier par ce qui suit. Le bloc `location ~ ^/(...)` correspond à la page de statut publique d'Uptime-Kuma et à ses ressources, et est servi directement, sans jamais atteindre la vérification `auth_request` du `location /` : +Remplacez le contenu du fichier par ce qui suit. Le bloc `location ~ ^/(...)` correspond à la page de statut publique d'Uptime-Kuma et à ses ressources, et est servi directement, sans jamais atteindre la vérification `auth_request` du `location /`. Seul `api/status-page` est laissé public, pas tout `/api`, car le reste de l'API d'Uptime-Kuma doit rester derrière l'authentification ; `/metrics` (l'endpoint Prometheus d'Uptime-Kuma) est volontairement absent de la regex pour la même raison : ```nginx [stats.subdomain.conf]{9-16,32-33} server { @@ -203,7 +203,7 @@ server { include /config/nginx/ssl.conf; - location ~ ^/(status|assets|icon\.svg|api|upload|metrics) { + location ~ ^/(status|assets|icon\.svg|api/status-page|upload) { include /config/nginx/proxy.conf; include /config/nginx/resolver.conf; set $upstream_app uptime-kuma; -- 2.54.0