# Tutorials **URL:** https://forum.yunohost.org/c/discuss/how-to/10.md [Latest](https://forum.yunohost.org/latest.md) · [Categories](https://forum.yunohost.org/categories.md) · [Tags](https://forum.yunohost.org/tags.md) --- ## [About the Tutorials category](https://forum.yunohost.org/t/about-the-tutorials-category/37)
**Author:** [@kload](https://forum.yunohost.org/u/kload)\ **Replies:** 0
This category is dedicated to tutorials and howtos, i.e. users that come with their knowledge and tips to share with the community. Post your questions in the Support and App support categories. :wink: --- ## [How to keep your mailbox outside yunohost](https://forum.yunohost.org/t/how-to-keep-your-mailbox-outside-yunohost/4860)
**Author:** [@ljf](https://forum.yunohost.org/u/ljf)\ **Replies:** 10\ **Last updated:** [September 10, 2026, 5:18pm UTC](https://forum.yunohost.org/t/how-to-keep-your-mailbox-outside-yunohost/4860 "2026-09-10T17:18:02Z")
This tuto is here to help you to configure your yunohost to be able to keep your mailbox @YOURDOMAIN.TLD on your registrar and to be able to send email to all adresses even the yours in @YOURDOMAIN.TLD. The problem Yuno… --- ## [Activer IPv6 pour YunoHost derrière Freebox tout en gardant le pare-feu pour son réseau local](https://forum.yunohost.org/t/activer-ipv6-pour-yunohost-derriere-freebox-tout-en-gardant-le-pare-feu-pour-son-reseau-local/41680)
**Author:** [@gauthier67](https://forum.yunohost.org/u/gauthier67)\ **Replies:** 1\ **Last updated:** [September 5, 2026, 1:01pm UTC](https://forum.yunohost.org/t/activer-ipv6-pour-yunohost-derriere-freebox-tout-en-gardant-le-pare-feu-pour-son-reseau-local/41680 "2026-09-05T13:01:16Z")
Problème Par défaut le pare-feu IPv6 (Firewall) de la Freebox est désactivé. Pour protéger ses PC et autres appareils qui n’ont pas de pare-feu, on active le pare-feu IPv6 de la Freebox Mais alors notre serveur YunoHost… --- ## [Ajouter vos propres applications et votre catalogue à YunoHost](https://forum.yunohost.org/t/ajouter-vos-propres-applications-et-votre-catalogue-a-yunohost/42880)
**Author:** [@manet](https://forum.yunohost.org/u/manet)\ **Replies:** 3\ **Last updated:** [September 5, 2026, 5:15am UTC](https://forum.yunohost.org/t/ajouter-vos-propres-applications-et-votre-catalogue-a-yunohost/42880 "2026-09-05T05:15:04Z")
Ajouter vos propres applications au catalogue YunoHost Guide pas-à-pas pour les amateurs — tout dans le navigateur, sauf une étape En une phrase Ce guide vous aide à faire apparaître vos applications personnalisées dans… --- ## [\[HOW-TO\] Install a Docker app (Immich) on Yunohost, integrated as much as I could - version 2026](https://forum.yunohost.org/t/how-to-install-a-docker-app-immich-on-yunohost-integrated-as-much-as-i-could-version-2026/42024)
**Author:** [@Pinipon](https://forum.yunohost.org/u/Pinipon)\ **Replies:** 7\ **Last updated:** [September 4, 2026, 12:44pm UTC](https://forum.yunohost.org/t/how-to-install-a-docker-app-immich-on-yunohost-integrated-as-much-as-i-could-version-2026/42024 "2026-09-04T12:44:38Z")
Introduction Disclaimer 1: This tutorial is a bit long and complex, and touches file that might break Yunohost or part of it. Do NOT proceed if you’re not sure of what you’re doing or you think it exceeds your current kn… --- ## [Run SQL queries for an app / Exécuter des requêtes SQL pour une app](https://forum.yunohost.org/t/run-sql-queries-for-an-app-executer-des-requetes-sql-pour-une-app/42928)
**Author:** [@fflorent](https://forum.yunohost.org/u/fflorent)\ **Replies:** 0\ **Last updated:** [September 4, 2026, 9:26am UTC](https://forum.yunohost.org/t/run-sql-queries-for-an-app-executer-des-requetes-sql-pour-une-app/42928 "2026-09-04T09:26:18Z")
(:france: Version française plus bas / French version below) Ever struggled, or taken much time to find out how to open an interactive shell to run SQL queries for an app? The new command yunohost app db \ is meant… --- ## [Quick tutorial : How to edit YunoHost Portal main color?](https://forum.yunohost.org/t/quick-tutorial-how-to-edit-yunohost-portal-main-color/42897)
**Author:** [@Gildas](https://forum.yunohost.org/u/Gildas)\ **Replies:** 0\ **Last updated:** [August 30, 2026, 8:17am UTC](https://forum.yunohost.org/t/quick-tutorial-how-to-edit-yunohost-portal-main-color/42897 "2026-08-30T08:17:19Z")
Français For english version, see below. Voici un court tutoriel pour vous montrer comment changer la couleur principale de l’interface utilisateur YunoHost, le portail. Par défaut, il s’agit du violet. Je n’ai pas trou… --- ## [Tuto: Bloquer les requêtes selon le pays](https://forum.yunohost.org/t/tuto-bloquer-les-requetes-selon-le-pays/9947)
**Author:** [@metyun](https://forum.yunohost.org/u/metyun)\ **Replies:** 113\ **Last updated:** [August 25, 2026, 8:37pm UTC](https://forum.yunohost.org/t/tuto-bloquer-les-requetes-selon-le-pays/9947 "2026-08-25T20:37:53Z")
Bonjour, Mise à jour du tuto le 23/08/26 Créer le hook suivant: /etc/yunohost/hooks.d/conf\_regen/18-nginx\_geoip #!/bin/bash # if not present, add package geoip-database with apt install geoip-database ############… --- ## [Configuration de Traefik en reverse proxy pour gérer 2 serveurs Yunohost derriére une seule IP](https://forum.yunohost.org/t/configuration-de-traefik-en-reverse-proxy-pour-gerer-2-serveurs-yunohost-derriere-une-seule-ip/42753)
**Author:** [@arnohgf](https://forum.yunohost.org/u/arnohgf)\ **Replies:** 0\ **Last updated:** [August 3, 2026, 12:46pm UTC](https://forum.yunohost.org/t/configuration-de-traefik-en-reverse-proxy-pour-gerer-2-serveurs-yunohost-derriere-une-seule-ip/42753 "2026-08-03T12:46:25Z")
Comme certains, j’héberge mon instance yunohost à la maison derrière une box . Le nom de domaine est défini chez OVH. J’en ai même 2. Un nom de domaine de production que nous appellerons yunohost.xyz et un nom de domaine… --- ## [How to start a bash shell for another user](https://forum.yunohost.org/t/how-to-start-a-bash-shell-for-another-user/42693)
**Author:** [@LasseGismo](https://forum.yunohost.org/u/LasseGismo)\ **Replies:** 8\ **Last updated:** [July 28, 2026, 4:28pm UTC](https://forum.yunohost.org/t/how-to-start-a-bash-shell-for-another-user/42693 "2026-07-28T16:28:58Z")
Hi. Sorry to bother you, but I’m not able to find the correct yunohost command to start a bash shell for another user. Can anyone help me please. Thanks. --- ## [Guide to install Nextcloud HPB: High Performance Backend (Nextcloud Signaling + CoTurn)](https://forum.yunohost.org/t/guide-to-install-nextcloud-hpb-high-performance-backend-nextcloud-signaling-coturn/42513)
**Author:** [@CypLef](https://forum.yunohost.org/u/CypLef)\ **Replies:** 3\ **Last updated:** [July 17, 2026, 7:00am UTC](https://forum.yunohost.org/t/guide-to-install-nextcloud-hpb-high-performance-backend-nextcloud-signaling-coturn/42513 "2026-07-17T07:00:19Z")
Here is a complete guide on how to install Nextcloud High Performance Backend (Nextcloud Signaling + CoTurn), in order to make videoconference with \>3 users. Prerequisite A working Yunohost Instance with admin access A… --- ## [Reinstall server from backup, a lil follow up](https://forum.yunohost.org/t/reinstall-server-from-backup-a-lil-follow-up/42558)
**Author:** [@cptbichez](https://forum.yunohost.org/u/cptbichez)\ **Replies:** 0\ **Last updated:** [July 2, 2026, 7:59pm UTC](https://forum.yunohost.org/t/reinstall-server-from-backup-a-lil-follow-up/42558 "2026-07-02T19:59:52Z")
Discuss So i’ve reinstalled my server on new hardware from a backup: install yunohost on the new hardware (i did from ISO) after post-install rsync’d the backup (the .tar) onto the new install at the right place that b… --- ## [Share your "hooks" to apply custom configurations- Partagez vos "hooks" pour appliquer des configurations personnelles](https://forum.yunohost.org/t/share-your-hooks-to-apply-custom-configurations-partagez-vos-hooks-pour-appliquer-des-configurations-personnelles/17235)
**Author:** [@metyun](https://forum.yunohost.org/u/metyun)\ **Replies:** 88\ **Last updated:** [June 30, 2026, 9:40pm UTC](https://forum.yunohost.org/t/share-your-hooks-to-apply-custom-configurations-partagez-vos-hooks-pour-appliquer-des-configurations-personnelles/17235 "2026-06-30T21:40:10Z")
:gb: English version Translate with DeePL A “hook” allows you to apply personal configurations to Yunohost files without the system detecting them as modified. Without a hook, Yunohost does not update these files and th… --- ## [Update public IP with nsupdate on LeBureau DNS zone](https://forum.yunohost.org/t/update-public-ip-with-nsupdate-on-lebureau-dns-zone/42540)
**Author:** [@Thatoo](https://forum.yunohost.org/u/Thatoo)\ **Replies:** 0\ **Last updated:** [June 29, 2026, 6:16pm UTC](https://forum.yunohost.org/t/update-public-ip-with-nsupdate-on-lebureau-dns-zone/42540 "2026-06-29T18:16:56Z")
If your server is behind a connection that may change its public IP and your registrar is LeBUreau, here is a way to update automatically the DNS zone. First, create your nsupdate key file /PATH/TO/YOUR/KEY.key based on… --- ## [Create your Intranet with a VPN and your own DNS, with YunoHost, Adguard, and Headscale](https://forum.yunohost.org/t/create-your-intranet-with-a-vpn-and-your-own-dns-with-yunohost-adguard-and-headscale/37393)
**Author:** [@tituspijean](https://forum.yunohost.org/u/tituspijean)\ **Replies:** 10\ **Last updated:** [June 12, 2026, 4:03pm UTC](https://forum.yunohost.org/t/create-your-intranet-with-a-vpn-and-your-own-dns-with-yunohost-adguard-and-headscale/37393 "2026-06-12T16:03:36Z")
Introduction Disclaimer: this tutorial is a bit complex and has only been tested a couple of times on my own setup. Please report any issue in a dedicated support thread. Feedback is most welcome. You might want to ci… --- ## [Zimablade 7700 NAS Kit setup](https://forum.yunohost.org/t/zimablade-7700-nas-kit-setup/42370)
**Author:** [@BlackKn33](https://forum.yunohost.org/u/BlackKn33)\ **Replies:** 1\ **Last updated:** [May 29, 2026, 5:26pm UTC](https://forum.yunohost.org/t/zimablade-7700-nas-kit-setup/42370 "2026-05-29T17:26:15Z")
Bonjour, je suis nouveau dans la communauté YunoHost. En effet je viens d’acheter la ZimaBlade 7700 avec le kit NAS de chez Zima. L’os préinstallé (Casaos) ne me plaisait pas alors je l’ai désinstallé pour installer Yuno… --- ## [Etendre son espace de stockage avec un volume storage sur un VPS chez hetzner](https://forum.yunohost.org/t/etendre-son-espace-de-stockage-avec-un-volume-storage-sur-un-vps-chez-hetzner/42152)
**Author:** [@ImaCrea](https://forum.yunohost.org/u/ImaCrea)\ **Replies:** 4\ **Last updated:** [May 22, 2026, 6:34am UTC](https://forum.yunohost.org/t/etendre-son-espace-de-stockage-avec-un-volume-storage-sur-un-vps-chez-hetzner/42152 "2026-05-22T06:34:13Z")
Hello :waving\_hand: Les offres VPS de Hetzner sont limitées à 40Gb, ensuite il faut mettre en place un Volume storage. Voici comment je m’y suis pris, en espérant que ça puisse en aider d’autres :slight\_smile: Approch… --- ## [Encrypt VPS based on cloudinit debian image](https://forum.yunohost.org/t/encrypt-vps-based-on-cloudinit-debian-image/42026)
**Author:** [@ljf](https://forum.yunohost.org/u/ljf)\ **Replies:** 2\ **Last updated:** [May 18, 2026, 11:39am UTC](https://forum.yunohost.org/t/encrypt-vps-based-on-cloudinit-debian-image/42026 "2026-05-18T11:39:29Z")
Introduction and warning This tutorial is a recap on an adminsys operation made in march 2026 with other yunohost.pro adminsys. I think it could be useful for some people so i have documented it here. This tutorial is q… --- ## [I learned: file name of conf\_regen hook matters for web UI and cron, but "yunohost tools regen-conf" always applies them?!](https://forum.yunohost.org/t/i-learned-file-name-of-conf-regen-hook-matters-for-web-ui-and-cron-but-yunohost-tools-regen-conf-always-applies-them/42226)
**Author:** [@m4lvin](https://forum.yunohost.org/u/m4lvin)\ **Replies:** 4\ **Last updated:** [May 10, 2026, 9:34pm UTC](https://forum.yunohost.org/t/i-learned-file-name-of-conf-regen-hook-matters-for-web-ui-and-cron-but-yunohost-tools-regen-conf-always-applies-them/42226 "2026-05-10T21:34:54Z")
What type of hardware are you using: VPS bought online What YunoHost version are you running: 12.1.39 (I solved the problem while writing this thanks to this PR by @abc from here :folded\_hands: but it might still confu… --- ## [Installer des polices dans Collabora (Nextcloud office)](https://forum.yunohost.org/t/installer-des-polices-dans-collabora-nextcloud-office/42022)
**Author:** [@ImaCrea](https://forum.yunohost.org/u/ImaCrea)\ **Replies:** 4\ **Last updated:** [April 27, 2026, 9:59pm UTC](https://forum.yunohost.org/t/installer-des-polices-dans-collabora-nextcloud-office/42022 "2026-04-27T21:59:29Z")
Hello à toutes et à tous :waving\_hand: J’utilise Nextcloud (33.0.2) et Collabora (25.04.9.4) connectés ensemble par l’app Nextcloud office (10.1.2). J’avais besoin aujourd’hui de pouvoir utiliser des nouvelles polices … --- ## [Nextcloud - how to add an external drive via the command line (CLI)](https://forum.yunohost.org/t/nextcloud-how-to-add-an-external-drive-via-the-command-line-cli/42055)
**Author:** [@tzb6js](https://forum.yunohost.org/u/tzb6js)\ **Replies:** 4\ **Last updated:** [April 15, 2026, 8:47am UTC](https://forum.yunohost.org/t/nextcloud-how-to-add-an-external-drive-via-the-command-line-cli/42055 "2026-04-15T08:47:01Z")
My version of Nextcloud came with a known bug. When you try to add an external storage drive through the admin web interface it fails and repeatedly asks for your password. I did some digging and found that you can add a… --- ## [YunoHost troubleshooting guide](https://forum.yunohost.org/t/yunohost-troubleshooting-guide/577)
**Author:** [@tostaki](https://forum.yunohost.org/u/tostaki)\ **Replies:** 17\ **Last updated:** [April 12, 2026, 4:53pm UTC](https://forum.yunohost.org/t/yunohost-troubleshooting-guide/577 "2026-04-12T16:53:54Z")
Hi, I’ve noticed that many yunohost users have trouble to find the real cause of their problems so I’ve decided to write a guide to help troubleshooting yunohost. You can consider this as some kind of administrator gui… --- ## [How to setup push notification with Synapse and Element (or Element X) Android](https://forum.yunohost.org/t/how-to-setup-push-notification-with-synapse-and-element-or-element-x-android/36897)
**Author:** [@Josue](https://forum.yunohost.org/u/Josue)\ **Replies:** 15\ **Last updated:** [April 10, 2026, 9:33am UTC](https://forum.yunohost.org/t/how-to-setup-push-notification-with-synapse-and-element-or-element-x-android/36897 "2026-04-10T09:33:20Z")
Context With the Arrival of Element X the new version of element for Android, users will need to have push notification configured correctly. For user which use Element X from Google play most of time it will work by def… --- ## [Get Grafana alerts over ntfy](https://forum.yunohost.org/t/get-grafana-alerts-over-ntfy/41868)
**Author:** [@u9000](https://forum.yunohost.org/u/u9000)\ **Replies:** 2\ **Last updated:** [March 23, 2026, 7:42am UTC](https://forum.yunohost.org/t/get-grafana-alerts-over-ntfy/41868 "2026-03-23T07:42:35Z")
What app is this about, and its version: Grafana, ntfy What YunoHost version are you running: 12.1.39 What type of hardware are you using: Other(?) Describe your issue i got grafana to work with ntfy, but it was a pai… --- ## [How to use Cloudflare Zero Trust tunnel with YunoHost](https://forum.yunohost.org/t/how-to-use-cloudflare-zero-trust-tunnel-with-yunohost/28095)
**Author:** [@CyberNeonHD](https://forum.yunohost.org/u/CyberNeonHD)\ **Replies:** 6\ **Last updated:** [March 23, 2026, 4:54am UTC](https://forum.yunohost.org/t/how-to-use-cloudflare-zero-trust-tunnel-with-yunohost/28095 "2026-03-23T04:54:52Z")
This guide will help you with finding the port, setting up correct firewall rules and adding it to cloudflare. I’m going to skip important Cloudflare steps as this is purely aimed add users who already now how to use Clo… --- ## [Configurer un backup Borg sur un Storage Box Hetzner](https://forum.yunohost.org/t/configurer-un-backup-borg-sur-un-storage-box-hetzner/41842)
**Author:** [@CypLef](https://forum.yunohost.org/u/CypLef)\ **Replies:** 3\ **Last updated:** [March 17, 2026, 11:01pm UTC](https://forum.yunohost.org/t/configurer-un-backup-borg-sur-un-storage-box-hetzner/41842 "2026-03-17T23:01:17Z")
Bonjour, Voici un petit tutoriel pour configurer un Backup Borg depuis votre serveur YunoHost sur un Storage Box chez Hetzner: Louez un storage box chez Hetzner: Autorisez la connexion ssh + l’accès extérieur Configu… --- ## [Successfully moved to a new server!](https://forum.yunohost.org/t/successfully-moved-to-a-new-server/37467)
**Author:** [@gcollin](https://forum.yunohost.org/u/gcollin)\ **Replies:** 3\ **Last updated:** [February 12, 2026, 7:32pm UTC](https://forum.yunohost.org/t/successfully-moved-to-a-new-server/37467 "2026-02-12T19:32:49Z")
ple relentlessly adding features to yunohost and supporting apps, I managed to move my self-hosted family site to a new server ! The situation I am happily hosting the photos, emails and documents of my family into a s… --- ## [YunoHost WebSocket CSP Issues and Fix](https://forum.yunohost.org/t/yunohost-websocket-csp-issues-and-fix/41022)
**Author:** [@hazzamyman](https://forum.yunohost.org/u/hazzamyman)\ **Replies:** 2\ **Last updated:** [February 10, 2026, 4:28am UTC](https://forum.yunohost.org/t/yunohost-websocket-csp-issues-and-fix/41022 "2026-02-10T04:28:34Z")
Executive Summary Multiple YunoHost-hosted applications (Home Assistant, Obsidian Web, Paperless-ngx, n8n) were experiencing WebSocket connection failures due to restrictive Content Security Policy (CSP) headers. The iss… --- ## [Moving my all of stuff from VPS to Raspberry Pi 4](https://forum.yunohost.org/t/moving-my-all-of-stuff-from-vps-to-raspberry-pi-4/41458)
**Author:** [@atakanozban](https://forum.yunohost.org/u/atakanozban)\ **Replies:** 3\ **Last updated:** [February 6, 2026, 10:37pm UTC](https://forum.yunohost.org/t/moving-my-all-of-stuff-from-vps-to-raspberry-pi-4/41458 "2026-02-06T22:37:01Z")
Hello, I’m going to move all of my stuff from my VDS server to Raspberry Pi 4 after a few days later. I’m hosting at home due to cost and storage related issues. Is there any optimized and easy method that you can sugge… --- ## [Retour d'expérience : Héberger Yunohost derrière Freebox + OPNsense + Proxmox](https://forum.yunohost.org/t/retour-dexperience-heberger-yunohost-derriere-freebox-opnsense-proxmox/40798)
**Author:** [@Issa](https://forum.yunohost.org/u/Issa)\ **Replies:** 5\ **Last updated:** [February 3, 2026, 9:03pm UTC](https://forum.yunohost.org/t/retour-dexperience-heberger-yunohost-derriere-freebox-opnsense-proxmox/40798 "2026-02-03T21:03:27Z")
Bonjour à tous, Voici un retour d’expérience pour installer Yunohost derrière une architecture Freebox + OPNsense + Proxmox, avec DNS local. L’objectif : web, mail et XMPP pleinement fonctionnels. 1. Architecture rés… [Next page](https://forum.yunohost.org/c/discuss/how-to/10.md?page=1)