Installation des plugins OMV-Extras : la procédure, commande par commande
Avant l’installation d’OMV-Extras, vérifier la version d’OpenMediaVault
Avant de lancer des commandes, vérifiez la version d’OpenMediaVault et la distribution Debian installée. En 2026, le script principal fourni par OMV-Extras vise OMV 8 sur Debian 13, tandis que les anciennes versions reposent sur des scripts distincts et non maintenus.
Cette distinction évite une confusion fréquente : l’installation d’OMV-Extras sur un serveur déjà configuré n’est pas la même opération que l’installation complète d’OpenMediaVault. Le premier ajoute notamment des dépôts et des outils complémentaires ; le second déploie le système sur une machine.
Contrôler l’environnement avant d’exécuter le script
Depuis l’interface d’administration ou une session SSH, notez la version d’OMV, la version de Debian et l’architecture du serveur. Si la machine héberge des données importantes, vérifiez aussi qu’une sauvegarde récente existe avant toute modification du système.
Selon la documentation OMV-Extras, les procédures ne sont pas identiques sur Raspberry Pi, Armbian et les systèmes AMD64. Les installations comportant un environnement de bureau ne sont pas prises en charge ; un système Debian léger est le choix prévu pour ce type de serveur.
Les contrôles utiles avant le lancement sont les suivants :
- Version d’OpenMediaVault et version Debian
- Connexion réseau stable et accès à une session administrateur
- Sauvegarde des données et des réglages importants
- Absence d’environnement de bureau installé sur le serveur
Distinguer OMV-Extras du script d’installation complète
Pour un serveur où OMV fonctionne déjà, utilisez le script d’installation des paquets OMV-Extras, et non le script de déploiement complet d’OpenMediaVault. Ce dernier peut installer OMV, OMV-Extras et le module writecache ; il peut aussi modifier la configuration réseau.
Selon le dépôt officiel des développeurs, le script OMV-Extras détecte la version d’OMV et télécharge les éléments correspondants. Pour une ancienne version arrivée en fin de vie, l’absence de maintenance peut empêcher l’installation ou provoquer des problèmes de dépendances.
Installation d’OMV-Extras dans le terminal, commande par commande
Une fois la version confirmée, l’installation se déroule dans le terminal avec les droits administrateur. La commande ci-dessous télécharge le script officiel depuis GitHub et le transmet à Bash ; elle ne doit être lancée que si l’origine du script est vérifiée.
Ouvrir une session administrateur et lancer la commande
Connectez-vous au serveur en SSH ou ouvrez un terminal local, puis passez en administrateur avec « sudo -i » si votre compte dispose des droits sudo. Une fois la session élevée ouverte, copiez la commande suivante sur une seule ligne.
wget -O – https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install | bash
Appuyez sur Entrée et laissez le script travailler sans fermer la session. Selon le réseau et les paquets à récupérer, le terminal affiche des messages de téléchargement et de configuration ; une interruption peut laisser l’opération incomplète.
Les étapes à suivre dans le terminal sont simples :
- Ouvrir une session sur le serveur OpenMediaVault
- Obtenir les droits administrateur avec sudo -i
- Exécuter la commande officielle sur une seule ligne
- Attendre la fin des opérations avant de fermer le terminal
Lire les messages et vérifier la fin de l’installation
Ne vous fiez pas uniquement à l’absence d’erreur visible : attendez le retour de l’invite de commande. Si le script signale un problème de connexion ou de dépôt logiciel, relevez le message exact avant de relancer l’opération.
Selon le dépôt GitHub des développeurs, cette commande installe le plugin OMV-Extras sur une installation OMV existante. Elle n’équivaut pas au script général qui sert à installer OMV lui-même sur un système vierge.
Vérifier le plugin et accéder aux outils complémentaires
Quand la commande se termine correctement, l’étape suivante se passe dans l’interface web. Actualisez la page d’administration, ouvrez la rubrique des plugins, puis recherchez le paquet OMV-Extras afin de confirmer que son installation est visible.
Actualiser l’interface et contrôler la présence du plugin
Si l’interface était déjà ouverte pendant l’installation, rechargez-la avant de chercher le plugin. Selon la version d’OMV, la présentation des menus peut varier ; vérifiez la rubrique des plugins et l’état du paquet plutôt que de vous fier à un emplacement unique.
Le dépôt OMV-Extras regroupe plusieurs extensions, mais leur disponibilité dépend de la version et des dépôts configurés. Le tableau ci-dessous présente des exemples de fonctions décrites par le projet, sans garantir que chaque paquet soit compatible avec toutes les versions.
Exemples de plugins et usages :
| Plugin | Usage principal |
|---|---|
| Compose | Gérer et lancer des fichiers Docker Compose |
| Backup | Sauvegarder le système hors disques de données |
| MergerFS | Regrouper des dossiers sous un point de montage commun |
| WireGuard | Configurer un accès VPN |
| Flashmemory | Réduire certaines écritures sur le stockage flash |
Choisir les extensions selon le besoin réel
Pour un serveur familial, Compose peut faciliter l’administration de services conteneurisés, tandis que BorgBackup ou rsnapshot répondent à des besoins de sauvegarde. Ces extensions ne remplacent toutefois ni une stratégie de sauvegarde testée ni la vérification régulière des restaurations.
Selon la documentation OMV-Extras, des plugins couvrent aussi la surveillance, les connexions distantes, le partage multimédia et la gestion de stockage. Installez seulement les outils utiles : limiter les composants réduit la complexité de configuration et simplifie l’administration système.
Résoudre les problèmes courants après l’installation
Si le plugin n’apparaît pas ou si le script échoue, examinez d’abord les causes les plus simples : version non prise en charge, résolution DNS défaillante ou accès réseau interrompu. Un dépôt logiciel inaccessible peut également empêcher la mise à jour des index de paquets.
Diagnostiquer une erreur de dépôt ou de réseau
Notez le texte complet de l’erreur, puis vérifiez que le serveur accède à Internet et résout les noms de domaine. Si le problème concerne un dépôt, évitez de supprimer des sources APT au hasard : une modification incorrecte peut bloquer les mises à jour d’autres composants.
Le plugin OMV-Extras comprend des fonctions liées aux dépôts et au nettoyage APT, mais elles ne dispensent pas d’identifier la cause avant toute correction. Sur un système ancien, vérifiez d’abord si la version Debian et les paquets requis sont encore disponibles.
Préserver la configuration réseau et demander de l’aide
Le script complet d’installation d’OMV peut modifier une configuration réseau existante, avec un risque particulier pour certaines installations Wi-Fi. Cette mise en garde concerne le déploiement complet du système ; pour l’ajout du plugin sur OMV déjà opérationnel, gardez tout de même une copie de vos réglages.
Avant de demander de l’aide sur le forum OpenMediaVault, indiquez les versions d’OMV et de Debian, la commande utilisée et les dernières lignes du message d’erreur. Cette description permet de distinguer rapidement un souci de compatibilité, de réseau ou de dépendances.
Ressources officielles : documentation OMV-Extras, « Documentation OMV-Extras », OMV-Extras.org ; « installScript », OpenMediaVault-Plugin-Developers sur GitHub ; forum OpenMediaVault, « Forum OpenMediaVault ».
