Ajouter des applications · TrueNAS SCALE de A à Z

C’est ici que le NAS devient un serveur. Mais c’est aussi ici que se prennent les mauvaises habitudes qui coûtent cher plus tard : des applications qui rangent leurs données on ne sait où, impossibles à sauvegarder ou à déplacer.

Étape 1 : choisir le pool des applications

La première fois que vous ouvrez Apps, TrueNAS vous demande sur quel pool installer les applications. Choisissez votre pool le plus rapide — un pool SSD si vous en avez un, sinon votre pool principal.

TrueNAS y crée un espace caché pour son fonctionnement. N’y touchez pas, et ne le supprimez jamais : c’est la fondation de toutes vos applications.

Étape 2 : parcourir le catalogue

L’onglet Discover ressemble à une boutique d’applications : Jellyfin, Nextcloud, AdGuard Home, Immich… Chacune est une application prête à déployer, dans un conteneur Docker isolé du reste du système.

Avant d’en installer une, lisez sa page : elle indique les ports utilisés et les dossiers dont elle a besoin. C’est l’information qui compte le plus.

Étape 3 : le stockage, le point qui fâche

Chaque application vous demande où ranger ses données. Deux possibilités :

Option	Ce que ça fait	Quand l’utiliser
ixVolume	TrueNAS crée et gère un espace pour vous	Pour tester, jamais pour des données qui comptent
Host Path	Vous désignez un dataset que vous avez créé	Pour tout ce que vous voulez garder, sauvegarder ou déplacer

Prenez Host Path, en pointant vers le dataset préparé à l’épisode 3 (tank/apps/jellyfin, par exemple). Vous saurez toujours où sont les données, et vous pourrez les sauvegarder avec le reste.

Étape 4 : les ports et le réseau

Chaque application expose son interface Web sur un port, indiqué dans sa fiche dans Apps. Deux applications ne peuvent pas utiliser le même port. Notez ceux que vous attribuez, dans un simple fichier texte : vous vous remercierez dans trois mois.

L’option Host Network donne à l’application un accès direct au réseau du NAS. Ne l’activez que si sa documentation l’exige.

Étape 5 : avant chaque mise à jour

Une mise à jour d’application peut modifier ses données. Avant toute mise à jour importante, prenez un snapshot du dataset de l’application : si quelque chose casse, vous revenez en arrière en un clic. L’épisode 14 montre comment l’automatiser.

Testez-vous

3 questions pour vérifier que l’essentiel est acquis. Rien n’est noté ni enregistré.

Où ranger les données d’une application que vous voulez garder ?

Depuis la version 24.10, sur quoi tournent les applications ?

Que faire avant une mise à jour importante d’une application ?

Vérifier que tout fonctionne

Cochez au fur et à mesure : quand tout est coché, vous pouvez passer à la suite.

Dans Apps, l’application affiche le statut Running

Son interface Web répond à http://adresse-du-nas:port

Ses données sont rangées dans un dataset que vous avez créé, et pas dans un espace géré à votre place

Aucune erreur n’apparaît dans les journaux de l’application

Problèmes courants

L’application reste bloquée sur « Deploying »

TrueNAS télécharge l’image de l’application : patientez quelques minutes. Si ça dure, vérifiez la connexion Internet du NAS et que le dataset indiqué pour les données existe bien.

L’application que je cherche n’est pas dans le catalogue

Le catalogue ne contient pas tout. Une application publiée sous forme d’image Docker peut s’installer avec l’option d’installation personnalisée — réservez-la aux applications dont vous comprenez la configuration.

L’application s’arrête ou redémarre en boucle

Ouvrez ses journaux depuis la page de l’application. Les deux causes les plus fréquentes : un port déjà utilisé par une autre application, ou des droits insuffisants sur le dataset de données.

J’ai lu qu’il fallait un dataset ix-applications

C’était vrai sur les anciennes versions, quand les applications tournaient sous Kubernetes. Depuis la version 24.10, elles tournent sous Docker, et TrueNAS gère son propre espace caché. Ne le supprimez pas, mais vous n’avez pas à y toucher.