From d22711484b22192a9bf21d2555fd9c362d59bd2b Mon Sep 17 00:00:00 2001 From: Djeex Date: Tue, 11 Aug 2026 08:48:59 +0000 Subject: [PATCH] feat: add SEO descriptions to all pages and fix canonical URL --- app.config.ts | 2 +- content/0.index.md | 1 + content/1.about/1.welcome.md | 1 + content/2.general/1.networking/1.nat.md | 1 + content/2.general/1.networking/2.dns.md | 1 + content/2.general/1.networking/3.samba.md | 1 + content/2.general/2.storage/1.raid.md | 1 + content/2.general/2.storage/2.zfs.md | 1 + content/2.general/3.hardware/1.basics.md | 1 + content/2.general/3.hardware/2.network.md | 1 + content/2.general/3.hardware/3.prolonas.md | 3 ++- content/3.serveex/1.introduction.md | 1 + content/3.serveex/2.core/1.installation.md | 1 + content/3.serveex/2.core/2.docker.md | 1 + content/3.serveex/2.core/3.swag.md | 1 + content/3.serveex/3.security/1.wireguard.md | 1 + content/3.serveex/3.security/2.authentik.md | 1 + content/3.serveex/3.security/3.cloudflare.md | 1 + content/3.serveex/4.monitoring/1.uptime-kuma.md | 1 + content/3.serveex/4.monitoring/2.dozzle.md | 1 + content/3.serveex/4.monitoring/3.speedtest-tracker.md | 1 + content/3.serveex/4.monitoring/4.beszel.md | 1 + content/3.serveex/4.monitoring/5.upsnap.md | 1 + content/3.serveex/5.media/1.plex.md | 1 + content/3.serveex/5.media/2.qbittorrent.md | 1 + content/3.serveex/5.media/3.servarr.md | 1 + content/3.serveex/6.cloud/1.immich.md | 1 + content/3.serveex/6.cloud/2.nextcloud.md | 1 + content/3.serveex/7.files/1.file-browser.md | 1 + content/3.serveex/7.files/2.pingvin.md | 1 + content/3.serveex/8.development/1.code-server.md | 1 + content/3.serveex/8.development/2.gitea.md | 1 + content/3.serveex/8.development/3.it-tools.md | 1 + content/3.serveex/9.apps/1.adguard.md | 1 + content/3.serveex/9.apps/2.vaultwarden.md | 1 + content/4.stockeex/1.introduction.md | 1 + content/5.nonsense/1.python/1.nvidia-stock-bot.md | 1 + content/5.nonsense/1.python/2. adguard-cidre.md | 1 + content/5.nonsense/1.python/3.lumeex.md | 1 + content/5.nonsense/1.python/4.instameex.md | 1 + content/5.nonsense/2.bash/1.servarr-duplicates.md | 1 + content/5.nonsense/2.bash/2.luks- backup.md | 1 + content/5.nonsense/2.bash/3.socat-proxy.md | 1 + content/5.nonsense/2.bash/4.hotdisk.md | 1 + content/5.nonsense/2.bash/5.backrest-docker-stop.md | 1 + 45 files changed, 46 insertions(+), 2 deletions(-) diff --git a/app.config.ts b/app.config.ts index d17522f..972962a 100644 --- a/app.config.ts +++ b/app.config.ts @@ -25,7 +25,7 @@ export default defineAppConfig({ docus: { title: 'Docudjeex', description: 'Homelab documentation', - url: 'http://docus.dev', + url: 'https://docu.djeex.fr', image: '/img/social.png', socials: { github:'', diff --git a/content/0.index.md b/content/0.index.md index 2f3bbb6..3213139 100644 --- a/content/0.index.md +++ b/content/0.index.md @@ -1,5 +1,6 @@ --- title: Home +description: Homelab documentation by Djeex — self-hosting guides for Debian, Docker, networking, storage, and more. navigation: false layout: page main: diff --git a/content/1.about/1.welcome.md b/content/1.about/1.welcome.md index f51555e..65e003a 100644 --- a/content/1.about/1.welcome.md +++ b/content/1.about/1.welcome.md @@ -1,6 +1,7 @@ --- icon: lucide:home title: Welcome +description: Introduction to Docudjeex — a personal homelab documentation site covering self-hosted services, Debian, and Docker infrastructure. main: fluid: false --- diff --git a/content/2.general/1.networking/1.nat.md b/content/2.general/1.networking/1.nat.md index bafce97..45c129f 100644 --- a/content/2.general/1.networking/1.nat.md +++ b/content/2.general/1.networking/1.nat.md @@ -1,6 +1,7 @@ --- navigation: true title: NAT & DHCP +description: Learn how NAT, port forwarding, and DHCP work on a home router. Configure fixed IP leases and understand how to expose local services. main: fluid: false --- diff --git a/content/2.general/1.networking/2.dns.md b/content/2.general/1.networking/2.dns.md index a6c61d7..2028967 100644 --- a/content/2.general/1.networking/2.dns.md +++ b/content/2.general/1.networking/2.dns.md @@ -1,6 +1,7 @@ --- navigation: true title: DNS Zone +description: Understand how DNS works, how to read and edit a DNS zone, and how to configure domain names for your self-hosted services. main: fluid: false --- diff --git a/content/2.general/1.networking/3.samba.md b/content/2.general/1.networking/3.samba.md index b4d8f78..c724234 100644 --- a/content/2.general/1.networking/3.samba.md +++ b/content/2.general/1.networking/3.samba.md @@ -1,6 +1,7 @@ --- navigation: true title: Samba +description: Set up Samba on Debian to share folders over your local network and access them from Windows, macOS, or Linux. main: fluid: false --- diff --git a/content/2.general/2.storage/1.raid.md b/content/2.general/2.storage/1.raid.md index 86491fa..8762ea2 100644 --- a/content/2.general/2.storage/1.raid.md +++ b/content/2.general/2.storage/1.raid.md @@ -1,6 +1,7 @@ --- navigation: true title: RAID +description: Understand RAID concepts — hardware vs software, RAID levels, and how to set up redundant disk arrays for your homelab. main: fluid: false --- diff --git a/content/2.general/2.storage/2.zfs.md b/content/2.general/2.storage/2.zfs.md index 2040739..2075267 100644 --- a/content/2.general/2.storage/2.zfs.md +++ b/content/2.general/2.storage/2.zfs.md @@ -1,6 +1,7 @@ --- navigation: true title: ZFS +description: Introduction to ZFS — a combined file system and volume manager with snapshots, checksums, and built-in redundancy for reliable homelab storage. main: fluid: false --- diff --git a/content/2.general/3.hardware/1.basics.md b/content/2.general/3.hardware/1.basics.md index cfa713a..c381e01 100644 --- a/content/2.general/3.hardware/1.basics.md +++ b/content/2.general/3.hardware/1.basics.md @@ -1,6 +1,7 @@ --- navigation: true title: The Basics +description: Overview of server hardware fundamentals — CPUs, RAM, storage, and form factors to understand before building your homelab. main: fluid: false --- diff --git a/content/2.general/3.hardware/2.network.md b/content/2.general/3.hardware/2.network.md index 73965e5..1e1fe36 100644 --- a/content/2.general/3.hardware/2.network.md +++ b/content/2.general/3.hardware/2.network.md @@ -1,6 +1,7 @@ --- navigation: true title: Network +description: Overview of networking hardware for homelabs — switches, NICs, cables, and how to connect your servers efficiently. main: fluid: false --- diff --git a/content/2.general/3.hardware/3.prolonas.md b/content/2.general/3.hardware/3.prolonas.md index f422a8d..90cbd08 100644 --- a/content/2.general/3.hardware/3.prolonas.md +++ b/content/2.general/3.hardware/3.prolonas.md @@ -1,6 +1,7 @@ --- navigation: true -title: The ProloNAS +title: The ProloNAS +description: Build a capable home server on a budget using an Intel N100 mini PC — a practical guide to getting started with self-hosting for under $130. fluid: false --- diff --git a/content/3.serveex/1.introduction.md b/content/3.serveex/1.introduction.md index db1e95b..6f5e928 100644 --- a/content/3.serveex/1.introduction.md +++ b/content/3.serveex/1.introduction.md @@ -2,6 +2,7 @@ icon: lucide:bookmark navigation: true title: Introduction +description: Introduction to Serveex — a personal homelab project to self-host everyday services using Debian and Docker, replacing Google, Apple, and Netflix. main: fluid: false --- diff --git a/content/3.serveex/2.core/1.installation.md b/content/3.serveex/2.core/1.installation.md index 4a64796..e82cc17 100644 --- a/content/3.serveex/2.core/1.installation.md +++ b/content/3.serveex/2.core/1.installation.md @@ -1,6 +1,7 @@ --- navigation: true title: Debian 13 +description: Step-by-step guide to install Debian 13 on a home server and set up SSH access, essential packages, and a ready-to-use base system. main: fluid: false --- diff --git a/content/3.serveex/2.core/2.docker.md b/content/3.serveex/2.core/2.docker.md index c167ce8..2fc5820 100644 --- a/content/3.serveex/2.core/2.docker.md +++ b/content/3.serveex/2.core/2.docker.md @@ -1,6 +1,7 @@ --- navigation: true title: Docker +description: Install Docker and Dockge on Debian to deploy and manage self-hosted services with simple container stacks. main: fluid: false --- diff --git a/content/3.serveex/2.core/3.swag.md b/content/3.serveex/2.core/3.swag.md index cc0c841..cb602f4 100644 --- a/content/3.serveex/2.core/3.swag.md +++ b/content/3.serveex/2.core/3.swag.md @@ -1,6 +1,7 @@ --- navigation: true title: SWAG +description: Set up SWAG as a reverse proxy with automatic SSL, expose your services securely, and configure geo-blocking on your homelab. main: fluid: false --- diff --git a/content/3.serveex/3.security/1.wireguard.md b/content/3.serveex/3.security/1.wireguard.md index 820efe6..cd52506 100644 --- a/content/3.serveex/3.security/1.wireguard.md +++ b/content/3.serveex/3.security/1.wireguard.md @@ -1,6 +1,7 @@ --- navigation: true title: Wireguard +description: Install and configure WireGuard VPN to securely access your homelab from anywhere and connect all your devices to your private network. main: fluid: false --- diff --git a/content/3.serveex/3.security/2.authentik.md b/content/3.serveex/3.security/2.authentik.md index 0d6714b..ce4bc52 100644 --- a/content/3.serveex/3.security/2.authentik.md +++ b/content/3.serveex/3.security/2.authentik.md @@ -1,6 +1,7 @@ --- navigation: true title: Authentik +description: Install Authentik as a self-hosted identity provider — configure MFA and protect your services with SSO and reverse proxy authentication. main: fluid: false --- diff --git a/content/3.serveex/3.security/3.cloudflare.md b/content/3.serveex/3.security/3.cloudflare.md index 63f1edc..91d5159 100644 --- a/content/3.serveex/3.security/3.cloudflare.md +++ b/content/3.serveex/3.security/3.cloudflare.md @@ -1,6 +1,7 @@ --- navigation: true title: Cloudflare Zero Trust +description: Use Cloudflare Tunnels and Zero Trust to expose homelab services without opening ports — configure SWAG and manage multiple tunnels. main: fluid: false --- diff --git a/content/3.serveex/4.monitoring/1.uptime-kuma.md b/content/3.serveex/4.monitoring/1.uptime-kuma.md index 297fc3d..ed3bc30 100644 --- a/content/3.serveex/4.monitoring/1.uptime-kuma.md +++ b/content/3.serveex/4.monitoring/1.uptime-kuma.md @@ -1,6 +1,7 @@ --- navigation: true title: Uptime-Kuma +description: Install Uptime-Kuma to monitor your self-hosted services uptime, set up alerts, and optionally protect the dashboard with Authentik. main: fluid: false --- diff --git a/content/3.serveex/4.monitoring/2.dozzle.md b/content/3.serveex/4.monitoring/2.dozzle.md index 6ab4bd7..e4d5cb5 100644 --- a/content/3.serveex/4.monitoring/2.dozzle.md +++ b/content/3.serveex/4.monitoring/2.dozzle.md @@ -1,6 +1,7 @@ --- navigation: true title: Dozzle +description: Install Dozzle to monitor Docker container logs in real time from a clean web interface, exposed via SWAG. main: fluid: false --- diff --git a/content/3.serveex/4.monitoring/3.speedtest-tracker.md b/content/3.serveex/4.monitoring/3.speedtest-tracker.md index f3cf1b4..b53b565 100644 --- a/content/3.serveex/4.monitoring/3.speedtest-tracker.md +++ b/content/3.serveex/4.monitoring/3.speedtest-tracker.md @@ -1,6 +1,7 @@ --- navigation: true title: Speedtest Tracker +description: Install Speedtest Tracker to automatically measure and log your internet connection speed over time, exposed with SWAG. main: fluid: false --- diff --git a/content/3.serveex/4.monitoring/4.beszel.md b/content/3.serveex/4.monitoring/4.beszel.md index 1556bc1..079cc41 100644 --- a/content/3.serveex/4.monitoring/4.beszel.md +++ b/content/3.serveex/4.monitoring/4.beszel.md @@ -1,6 +1,7 @@ --- navigation: true title: Beszel +description: Install Beszel to monitor server CPU, RAM, disk, and network metrics — including remote servers — with a lightweight web dashboard. main: fluid: false --- diff --git a/content/3.serveex/4.monitoring/5.upsnap.md b/content/3.serveex/4.monitoring/5.upsnap.md index 8f76567..6ba835d 100644 --- a/content/3.serveex/4.monitoring/5.upsnap.md +++ b/content/3.serveex/4.monitoring/5.upsnap.md @@ -1,6 +1,7 @@ --- navigation: true title: UpSnap +description: Install UpSnap to remotely wake up machines on your local network via Wake-on-LAN, exposed with SWAG. main: fluid: false --- diff --git a/content/3.serveex/5.media/1.plex.md b/content/3.serveex/5.media/1.plex.md index a80e064..8c740cf 100644 --- a/content/3.serveex/5.media/1.plex.md +++ b/content/3.serveex/5.media/1.plex.md @@ -1,6 +1,7 @@ --- navigation: true title: Plex +description: Install Plex Media Server with Tautulli on your homelab to stream movies and TV shows from anywhere on all your devices. main: fluid: false --- diff --git a/content/3.serveex/5.media/2.qbittorrent.md b/content/3.serveex/5.media/2.qbittorrent.md index c0c22fe..d672ae7 100644 --- a/content/3.serveex/5.media/2.qbittorrent.md +++ b/content/3.serveex/5.media/2.qbittorrent.md @@ -1,6 +1,7 @@ --- navigation: true title: Qbittorrent +description: Install qBittorrent with Gluetun and ProtonVPN to download torrents securely behind a VPN on your self-hosted server. main: fluid: false --- diff --git a/content/3.serveex/5.media/3.servarr.md b/content/3.serveex/5.media/3.servarr.md index 68dd127..b6acac2 100644 --- a/content/3.serveex/5.media/3.servarr.md +++ b/content/3.serveex/5.media/3.servarr.md @@ -1,6 +1,7 @@ --- navigation: true title: Automation +description: Automate media downloads with the Servarr stack — Radarr, Sonarr, Bazarr, Prowlarr, and Overseerr for movies and TV shows. main: fluid: false --- diff --git a/content/3.serveex/6.cloud/1.immich.md b/content/3.serveex/6.cloud/1.immich.md index 8ed4b1d..24bc1a3 100644 --- a/content/3.serveex/6.cloud/1.immich.md +++ b/content/3.serveex/6.cloud/1.immich.md @@ -1,6 +1,7 @@ --- navigation: true title: Immich +description: Install Immich, a self-hosted alternative to Google Photos and iCloud with face recognition, geolocation, and multi-device sync. main: fluid: false --- diff --git a/content/3.serveex/6.cloud/2.nextcloud.md b/content/3.serveex/6.cloud/2.nextcloud.md index 6b13e9d..e17deda 100644 --- a/content/3.serveex/6.cloud/2.nextcloud.md +++ b/content/3.serveex/6.cloud/2.nextcloud.md @@ -1,6 +1,7 @@ --- navigation: true title: Nextcloud +description: Install Nextcloud to self-host your files, photos, and calendar — a privacy-friendly alternative to Google Drive, OneDrive, and iCloud. main: fluid: false --- diff --git a/content/3.serveex/7.files/1.file-browser.md b/content/3.serveex/7.files/1.file-browser.md index 2b8f7e8..7722cc1 100644 --- a/content/3.serveex/7.files/1.file-browser.md +++ b/content/3.serveex/7.files/1.file-browser.md @@ -1,6 +1,7 @@ --- navigation: true title: File Browser +description: Install File Browser to browse and manage your server files from a web interface, exposed securely with SWAG. main: fluid: false --- diff --git a/content/3.serveex/7.files/2.pingvin.md b/content/3.serveex/7.files/2.pingvin.md index 78d2a46..192ef07 100644 --- a/content/3.serveex/7.files/2.pingvin.md +++ b/content/3.serveex/7.files/2.pingvin.md @@ -1,6 +1,7 @@ --- navigation: true title: Pingvin +description: Install Pingvin Share, a self-hosted file sharing platform to send files securely without relying on WeTransfer or Google Drive. main: fluid: false --- diff --git a/content/3.serveex/8.development/1.code-server.md b/content/3.serveex/8.development/1.code-server.md index b138d68..838bced 100644 --- a/content/3.serveex/8.development/1.code-server.md +++ b/content/3.serveex/8.development/1.code-server.md @@ -1,6 +1,7 @@ --- navigation: true title: Code-Server +description: Install code-server to run VS Code in your browser from your homelab — mount folders and expose it securely with SWAG. main: fluid: false --- diff --git a/content/3.serveex/8.development/2.gitea.md b/content/3.serveex/8.development/2.gitea.md index ff14cbd..c5eb787 100644 --- a/content/3.serveex/8.development/2.gitea.md +++ b/content/3.serveex/8.development/2.gitea.md @@ -1,6 +1,7 @@ --- navigation: true title: Gitea +description: Install Gitea, a lightweight self-hosted Git service to manage your code repositories privately on your own server. main: fluid: false --- diff --git a/content/3.serveex/8.development/3.it-tools.md b/content/3.serveex/8.development/3.it-tools.md index 104255c..a408f4c 100644 --- a/content/3.serveex/8.development/3.it-tools.md +++ b/content/3.serveex/8.development/3.it-tools.md @@ -1,6 +1,7 @@ --- navigation: true title: IT Tools +description: Install IT Tools, a self-hosted collection of handy utilities for developers — converters, encoders, formatters, and more. main: fluid: false --- diff --git a/content/3.serveex/9.apps/1.adguard.md b/content/3.serveex/9.apps/1.adguard.md index 503d2b4..a12ab79 100644 --- a/content/3.serveex/9.apps/1.adguard.md +++ b/content/3.serveex/9.apps/1.adguard.md @@ -1,6 +1,7 @@ --- navigation: true title: Adguard Home +description: Install AdGuard Home for network-wide ad and tracker blocking with DNS-over-HTTPS, client management, and custom filtering rules. main: fluid: false --- diff --git a/content/3.serveex/9.apps/2.vaultwarden.md b/content/3.serveex/9.apps/2.vaultwarden.md index 5ba8037..fcb9ec0 100644 --- a/content/3.serveex/9.apps/2.vaultwarden.md +++ b/content/3.serveex/9.apps/2.vaultwarden.md @@ -1,6 +1,7 @@ --- navigation: true title: Vaultwarden +description: Install Vaultwarden, a self-hosted Bitwarden-compatible password manager to replace Google or Apple password managers across all your devices. main: fluid: false --- diff --git a/content/4.stockeex/1.introduction.md b/content/4.stockeex/1.introduction.md index 0f6f109..14aa857 100644 --- a/content/4.stockeex/1.introduction.md +++ b/content/4.stockeex/1.introduction.md @@ -2,6 +2,7 @@ icon: lucide:bookmark navigation: true title: Introduction +description: Introduction to Stockeex — a personal project for stock and inventory management. Documentation coming soon. main: fluid: false --- diff --git a/content/5.nonsense/1.python/1.nvidia-stock-bot.md b/content/5.nonsense/1.python/1.nvidia-stock-bot.md index 7d4267f..bc4a75f 100644 --- a/content/5.nonsense/1.python/1.nvidia-stock-bot.md +++ b/content/5.nonsense/1.python/1.nvidia-stock-bot.md @@ -1,6 +1,7 @@ --- navigation: true title: Nvidia Stock Bot +description: A Python bot that monitors GPU stock availability in real time and sends Discord alerts — built during the RTX 5000 series launch shortage. main: fluid: false --- diff --git a/content/5.nonsense/1.python/2. adguard-cidre.md b/content/5.nonsense/1.python/2. adguard-cidre.md index d0e9712..bfd03d1 100644 --- a/content/5.nonsense/1.python/2. adguard-cidre.md +++ b/content/5.nonsense/1.python/2. adguard-cidre.md @@ -1,6 +1,7 @@ --- navigation: true title: Adguard CIDRE +description: A Python script to sync AdGuard Home CIDR allowlists automatically, securing your self-hosted DNS server exposed to the internet. main: fluid: false --- diff --git a/content/5.nonsense/1.python/3.lumeex.md b/content/5.nonsense/1.python/3.lumeex.md index 8667f07..5dd4092 100644 --- a/content/5.nonsense/1.python/3.lumeex.md +++ b/content/5.nonsense/1.python/3.lumeex.md @@ -1,6 +1,7 @@ --- navigation: true title: Lumeex +description: Lumeex is a static photo gallery site generator built with Python — minimalist, lightweight, and fully customizable without a CMS. main: fluid: false --- diff --git a/content/5.nonsense/1.python/4.instameex.md b/content/5.nonsense/1.python/4.instameex.md index 5c5af3d..93cbd93 100644 --- a/content/5.nonsense/1.python/4.instameex.md +++ b/content/5.nonsense/1.python/4.instameex.md @@ -1,6 +1,7 @@ --- navigation: true title: Instameex +description: Instameex is a Docker-based tool to merge SDR and HDR photo exports into a proper gain-map JPEG ready for Instagram HDR upload. main: fluid: false --- diff --git a/content/5.nonsense/2.bash/1.servarr-duplicates.md b/content/5.nonsense/2.bash/1.servarr-duplicates.md index bf59f86..75ad1bd 100644 --- a/content/5.nonsense/2.bash/1.servarr-duplicates.md +++ b/content/5.nonsense/2.bash/1.servarr-duplicates.md @@ -1,6 +1,7 @@ --- navigation: true title: Servarr corrector +description: A bash script to detect and fix duplicate media files in Sonarr and Radarr libraries by replacing copies with hardlinks to reclaim disk space. main: fluid: false --- diff --git a/content/5.nonsense/2.bash/2.luks- backup.md b/content/5.nonsense/2.bash/2.luks- backup.md index 64da0f3..677086f 100644 --- a/content/5.nonsense/2.bash/2.luks- backup.md +++ b/content/5.nonsense/2.bash/2.luks- backup.md @@ -1,6 +1,7 @@ --- navigation: true title: LUKS Backup +description: A bash script to automatically dump LUKS headers from all encrypted disks, identify them by serial number, and store them in an encrypted archive. main: fluid: false --- diff --git a/content/5.nonsense/2.bash/3.socat-proxy.md b/content/5.nonsense/2.bash/3.socat-proxy.md index 03bbb32..d103e46 100644 --- a/content/5.nonsense/2.bash/3.socat-proxy.md +++ b/content/5.nonsense/2.bash/3.socat-proxy.md @@ -1,6 +1,7 @@ --- navigation: true title: Socat Proxy +description: Use socat to proxy the Docker socket through Docker Socket Proxy, allowing Beszel to collect container stats without exposing the full Docker socket. main: fluid: false --- diff --git a/content/5.nonsense/2.bash/4.hotdisk.md b/content/5.nonsense/2.bash/4.hotdisk.md index 03e0223..f92c94f 100644 --- a/content/5.nonsense/2.bash/4.hotdisk.md +++ b/content/5.nonsense/2.bash/4.hotdisk.md @@ -1,6 +1,7 @@ --- navigation: true title: HotDisk +description: A bash script that monitors hard drive temperatures and automatically shuts down the server when disks stay above a safe threshold for too long. main: fluid: false --- diff --git a/content/5.nonsense/2.bash/5.backrest-docker-stop.md b/content/5.nonsense/2.bash/5.backrest-docker-stop.md index c00c56e..b3ff768 100644 --- a/content/5.nonsense/2.bash/5.backrest-docker-stop.md +++ b/content/5.nonsense/2.bash/5.backrest-docker-stop.md @@ -1,6 +1,7 @@ --- navigation: true title: Backrest Docker Stop +description: A bash script that stops Docker containers before a Backrest backup runs and restarts them after — ensuring safe database backups without complex dumps. main: fluid: false ---