Démarrage rapide
Vous pouvez installer CasaOS sur un mini PC ou un serveur domestique en préparant d'abord un système Linux de base compatible, en vous assurant d'accéder à la machine via un terminal local ou SSH, puis en exécutant l'installateur CasaOS depuis la ligne de commande. Pour la plupart des débutants, le chemin le plus simple est : installer un système Linux serveur propre, connecter la machine à votre réseau local, mettre à jour le système, exécuter l'installateur CasaOS et ouvrir le tableau de bord depuis un autre appareil sur le même réseau.
L'essentiel est que CasaOS n'est généralement pas le premier système d'exploitation que vous installez sur le matériel. Il fonctionne au-dessus d'un système hôte compatible, donc le système de base, la configuration réseau, la configuration du stockage et l'accès au terminal sont tous importants avant que le tableau de bord CasaOS n'apparaisse.
Un processus sécurisé pour débutants ressemble à ceci :
-
Confirmez que le matériel de votre mini PC ou serveur est compatible.
-
Installez un système Linux de base propre.
-
Assurez-vous que le serveur dispose d'un accès réseau stable.
-
Accédez au terminal localement ou via SSH.
-
Exécutez l'installateur CasaOS.
-
Ouvrez le tableau de bord web et créez votre compte administrateur.
-
Vérifiez si les chemins de stockage, des applications et des données Docker fonctionnent comme prévu.
Qu'est-ce que CasaOS et que fait-il réellement installer ?
CasaOS est une interface de serveur domestique conçue pour simplifier l'auto-hébergement. Au lieu de demander aux débutants de gérer chaque service manuellement depuis la ligne de commande, il offre aux utilisateurs un tableau de bord web pour les applications, fichiers, disques et la gestion basique du serveur.
La distinction importante est que CasaOS n'est généralement pas installé comme un système d'exploitation autonome complet sur un matériel nu. Selon les instructions rapides de configuration de CasaOS, la procédure recommandée est d'installer d'abord un système pris en charge fraîchement, puis d'exécuter une commande d'installation en une ligne sur ce système.
Cela signifie que CasaOS fonctionne davantage comme une couche de gestion au-dessus d'un hôte Linux. Le système de base gère la machine, le réseau, les paquets, les utilisateurs et le comportement système bas niveau, tandis que CasaOS vous offre une interface plus conviviale pour les tâches de serveur domestique.
Ce dont vous avez besoin avant d'installer CasaOS sur un mini PC
Avant d'installer CasaOS, considérez votre mini PC comme un petit serveur qui a besoin de cinq éléments pour fonctionner correctement : un matériel compatible, un système d'exploitation de base propre, un accès réseau, un accès au terminal et un stockage visible par le système hôte.
| Exigence | Pourquoi c'est important | Ce qu'il faut vérifier en premier |
| Matériel compatible | L'installateur et les services nécessitent une architecture CPU et un système hôte pris en charge | Architecture CPU, stockage, RAM, capacité de démarrage USB |
| Système Linux de base propre | CasaOS fonctionne au-dessus d'un système hôte dans de nombreuses configurations | Debian, Ubuntu Server, Raspberry Pi OS ou un autre système pris en charge |
| Réseau local stable | Le tableau de bord web est généralement accessible via une adresse IP locale | Connexion Ethernet ou réseau local fiable |
| Accès au terminal | L'installateur s'exécute depuis une ligne de commande | Clavier/moniteur local ou SSH |
| Visibilité du stockage | Les applications et fichiers dépendent de ce que le système hôte peut voir | Disques internes, disques montés, permissions |
Un mini PC ou serveur domestique compatible
CasaOS peut fonctionner sur plusieurs appareils de serveur domestique courants, mais la compatibilité doit être vérifiée avant l'installation. Les notes officielles de compatibilité listent des architectures telles que amd64 / x86-64, arm64 et armv7, et mentionnent des systèmes comme ZimaBoard, Intel NUC et Raspberry Pi comme exemples supportés.
Pour un mini PC, les principales vérifications pratiques sont de savoir si la machine peut démarrer un système Linux supporté, si elle dispose de suffisamment de stockage pour le système d'exploitation de base et les applications, et si elle peut rester en ligne en tant que serveur toujours actif. Si l'appareil a plusieurs disques ou un stockage externe, le système hôte doit les reconnaître et les monter avant que CasaOS puisse les gérer de manière utile.
Un système Linux de base propre
Pour la plupart des débutants, un système d'exploitation de base propre est plus facile à dépanner qu'une machine qui a déjà de nombreux paquets, anciens services ou montages de stockage peu clairs. La documentation de CasaOS liste Debian 12 comme testé et recommandé, et Ubuntu Server 20.04 comme testé, ce qui en fait des points de départ raisonnables lorsque le matériel les supporte.
Un système de base propre réduit l'incertitude. Si une commande d'installation échoue, vous pouvez limiter le problème au réseau, au paquet, aux permissions ou à la compatibilité au lieu de deviner si d'anciens services interfèrent.
Une connexion réseau locale stable
CasaOS devient utile uniquement après que vous puissiez atteindre la machine depuis un autre appareil sur le même réseau local. Si le serveur ne peut pas obtenir d'adresse IP, le tableau de bord web sera difficile à ouvrir même si l'installation est terminée.
Pour les configurations sans écran, SSH est souvent le moyen pratique de gérer le serveur. Ubuntu décrit OpenSSH comme un moyen sécurisé de contrôler à distance des ordinateurs en réseau et de transférer des données, et sa documentation d'installation du serveur OpenSSH explique que le composant serveur écoute les connexions clients et prend en charge les sessions de contrôle à distance après authentification.
Un moyen d'accéder au terminal
Vous avez besoin d'un accès au terminal car l'installation de CasaOS dépend de l'exécution d'une commande sur le système hôte. Cela peut se faire directement avec un moniteur et un clavier, ou à distance via SSH si le système d'exploitation de base a l'accès à distance activé.
Soyez prudent lors de la modification de la configuration SSH sur une machine accessible uniquement à distance. Si SSH est votre seul moyen d'accès et que la configuration est modifiée incorrectement, vous risquez de perdre la possibilité d'atteindre le serveur sans accès physique.
Le chemin d'installation simple pour un premier serveur domestique
Une façon simple pour les débutants de penser à l'installation est Le chemin d'installation de la base au tableau de bord. Il sépare le processus en couches de responsabilité pour que vous puissiez comprendre ce que chaque partie est censée faire.
| Couche d'installation | Ce que cela couvre | Signal de réussite | Point de défaillance courant |
| Préparation matérielle | Mini PC, stockage, démarrage USB, plan d'affichage ou SSH | Le périphérique peut démarrer un installateur ou un système de base | Démarrage USB désactivé, mauvais mode de démarrage, périphérique non supporté |
| Couche système d'exploitation de base | Debian, Ubuntu Server ou un autre hôte compatible | Le système d'exploitation démarre et vous pouvez vous connecter | OS mal installé, mauvaise architecture |
| Accès réseau et terminal | Connexion LAN, adresse IP, SSH ou terminal local | Vous pouvez atteindre la machine et exécuter des commandes | Pas d'adresse IP, SSH non activé, connexion instable |
| Chemin de l'installateur et du tableau de bord | Mise à jour du système, installateur CasaOS, tableau de bord web | Le tableau de bord CasaOS s'ouvre dans un navigateur | Échec de l'installateur, commande indisponible, problème réseau |
| Validation à la première utilisation | Disques, applications, stockage Docker, étapes suivantes | Les applications et le stockage fonctionnent comme prévu | Disques non montés, chemin des données d'applications peu clair |
Ce cadre évite une erreur courante chez les débutants : considérer l'installateur CasaOS comme la seule étape importante. En pratique, l'installateur n'est qu'une couche dans un chemin plus long allant du matériel à un tableau de bord de serveur domestique fonctionnel.
Étape 1 : Choisir le bon système d'exploitation de base
Choisissez un système d'exploitation de base qui est supporté, bien documenté et adapté à votre niveau de compétence. Pour la plupart des débutants, Debian ou Ubuntu Server est plus facile à rechercher et à dépanner qu'une distribution Linux de niche ou fortement personnalisée.
Le choix est important car CasaOS dépend du système hôte pour les paquets, le réseau, les utilisateurs, le stockage et les permissions. Si le système de base est instable ou inconnu, dépanner CasaOS devient plus difficile par la suite.
Étape 2 : Flasher et installer le système de base
Pour installer un système d'exploitation de base, vous téléchargez généralement une image OS, l'écrivez sur une clé USB, démarrez le mini PC depuis cette clé, puis suivez l'installateur. C'est là que l'accès au BIOS ou au menu de démarrage est important.
Avant d'écrire une image sur une clé USB, confirmez que vous avez sélectionné le bon périphérique cible. Flasher une image peut effacer la clé USB sélectionnée, et choisir la mauvaise cible peut détruire les données d'un autre disque.
Étape 3 : Mettre à jour le système avant d'installer quoi que ce soit
Une fois le système d'exploitation de base installé, mettez à jour le système avant d'ajouter CasaOS. Cela réduit les risques de conflits de dépendances, d'index de paquets obsolètes ou d'outils manquants lors de l'installation.
Pour la plupart des débutants, c'est aussi le moment où vous devez confirmer que le serveur a accès au réseau et que vous pouvez y accéder de manière fiable. Si vous utilisez SSH, testez la connexion avant de commencer des étapes d'installation plus longues.
Étape 4 : Exécuter l'installateur CasaOS
Une fois le système de base prêt, exécutez la commande d'installation de CasaOS depuis le terminal. La documentation de CasaOS propose des options d'installation en une seule ligne utilisant
wget ou curl, donc l'hôte a besoin d'un accès Internet et des outils en ligne de commande requis.Ne collez pas de commandes dans une machine que vous ne comprenez pas sans vérifier d'abord la source. Pour un serveur domestique, surtout s'il doit stocker des fichiers personnels, il est plus sûr de confirmer que l'installateur provient de la source officielle du projet avant de l'exécuter avec des permissions élevées.
Étape 5 : Ouvrez le tableau de bord web et créez votre compte administrateur
Lorsque l'installation est terminée, CasaOS devrait fournir un moyen d'accéder au tableau de bord depuis un navigateur, généralement via l'adresse IP locale du serveur. Utilisez un appareil sur le même réseau et ouvrez l'adresse du tableau de bord dans le navigateur.
Créer le compte administrateur n'est pas la fin de la configuration. Après la première connexion, confirmez que le tableau de bord se charge de manière cohérente, que le stockage est visible et que les applications que vous installez peuvent stocker des données là où vous l'attendez.
CasaOS n'est pas un système d'exploitation complet : pourquoi c'est important
CasaOS est souvent décrit comme un système d'exploitation pour serveur domestique car le tableau de bord donne l'impression d'un environnement complet. Cependant, dans une installation typique, l'hôte Linux sous-jacent est toujours responsable du système bas niveau.
Cela importe car certains problèmes ne sont pas vraiment des problèmes de CasaOS. Si l'appareil ne démarre pas, le problème se situe probablement en dessous de CasaOS. Si le serveur n'a pas d'adresse IP, le tableau de bord ne peut pas être atteint. Si un disque n'est pas monté par le système d'exploitation hôte, il peut ne pas apparaître dans l'interface CasaOS comme un débutant pourrait s'y attendre.
Une frontière simple est :
-
Le système d'exploitation de base gère le démarrage, les utilisateurs, les paquets, le réseau, les disques et les services système.
-
CasaOS fournit le tableau de bord, la couche de gestion des applications et une interface simplifiée pour serveur domestique.
-
Les applications Docker apportent leur propre comportement de conteneur, y compris des chemins séparés et des règles de stockage persistant.
Problèmes d'installation courants rencontrés par les nouveaux utilisateurs
Beaucoup de problèmes initiaux surviennent parce que les utilisateurs sautent une étape dans le chemin d'installation. L'installateur peut être correct, mais le système d'exploitation de base, le réseau, l'accès au terminal, le montage du stockage ou le chemin Docker peuvent encore être incorrects.
L'URL de l'installateur ne répond pas
Si l'URL de l'installateur ne répond pas, évitez d'exécuter plusieurs fois des commandes copiées au hasard depuis des forums ou d'anciens tutoriels. Vérifiez d'abord si le serveur a accès à Internet, si le DNS fonctionne et si la source officielle d'installation est accessible depuis un autre appareil.
Un ordre pratique est :
-
Testez la connectivité réseau sur le serveur.
-
Confirmez que la commande a été copiée correctement.
-
Vérifiez si
curlouwgetest installé. -
Vérifiez la source de l'installateur sur la page officielle de CasaOS.
-
Attendez et réessayez plus tard si le point d'accès semble temporairement indisponible.
L'adresse IP du serveur est difficile à trouver
Si vous ne trouvez pas l'adresse IP du serveur, le tableau de bord peut fonctionner mais être inaccessible. Vérifiez la liste des appareils de votre routeur, la console du serveur ou la sortie des commandes réseau sur le système d'exploitation de base.
C'est aussi pourquoi l'Ethernet est souvent plus simple pour la première configuration. Une connexion filaire élimine les problèmes d'identifiants Wi-Fi et de signal lors de l'installation initiale, ce qui facilite l'isolation des problèmes.
Les disques n'apparaissent pas dans le tableau de bord
Si un disque n'apparaît pas dans CasaOS, vérifiez d'abord si le système d'exploitation de base détecte le disque. CasaOS ne peut pas gérer de manière fiable un stockage que le système hôte n'a pas détecté, monté ou auquel il n'a pas accordé les permissions appropriées.
Pour les nouveaux disques, cela peut impliquer le formatage, le montage et la confirmation que le montage persiste après un redémarrage. Soyez prudent avec les opérations de formatage car elles peuvent effacer les données existantes.
Les applications Docker fonctionnent mais les chemins de stockage semblent confus
Une application Docker peut sembler fonctionner même si le chemin de stockage n'est pas celui attendu par l'utilisateur. Les conteneurs peuvent créer, modifier et supprimer des fichiers dans leur propre environnement, mais ces modifications peuvent disparaître si le conteneur est supprimé à moins qu'un stockage persistant ne soit configuré.
Docker explique cela via les volumes : le guide de persistance des données des conteneurs Docker décrit les volumes comme un mécanisme de stockage qui conserve les données au-delà du cycle de vie d'un conteneur individuel. Pour les utilisateurs de CasaOS, cela signifie que les données des applications, le stockage hôte et les chemins des conteneurs doivent être vérifiés avant de considérer une configuration comme terminée.
Comment vérifier si votre configuration de serveur domestique fonctionne
Une configuration CasaOS fonctionnelle est plus qu'une commande d'installation réussie. Vous devez vérifier le système de la couche matérielle jusqu'à la couche application.
Utilisez cette liste de contrôle après l'installation :
-
Le mini PC démarre sans la clé USB d'installation.
-
Le système d'exploitation de base est accessible localement ou via SSH.
-
Le tableau de bord CasaOS s'ouvre depuis un autre appareil sur le même réseau.
-
Vous pouvez vous connecter avec le compte administrateur que vous avez créé.
-
Les disques internes ou externes apparaissent là où ils sont attendus.
-
Une application simple peut être installée et ouverte.
-
Les données des applications sont stockées à un emplacement que vous comprenez.
-
Le serveur fonctionne toujours après un redémarrage.
Si un élément échoue, utilisez le chemin de configuration Base-vers-Tableau de bord pour localiser la couche probable. Les problèmes matériels et de démarrage sont différents des problèmes d'accès au tableau de bord, et les problèmes de stockage Docker sont différents des problèmes d'installation de CasaOS.
Quand CasaOS peut ne pas être le meilleur choix à long terme
CasaOS convient aux utilisateurs qui souhaitent un tableau de bord simple pour l'auto-hébergement léger et les applications de serveur domestique. Il peut ne pas être le meilleur choix si votre objectif principal est la gestion avancée du stockage, la virtualisation complexe, les flux de travail NAS multi-disques importants, ou un système où vous souhaitez gérer Docker Compose directement sans couche de tableau de bord.
Ce n'est pas une raison d'éviter CasaOS. C'est une raison d'adapter l'outil à la tâche. Pour la plupart des débutants, CasaOS peut être un point d'entrée utile ; pour des configurations plus complexes et axées sur le stockage, vous pourriez éventuellement avoir besoin d'un NAS ou d'une plateforme de virtualisation plus spécialisée.
Une règle de décision pratique :
| Si votre objectif principal est... | Adaptation CasaOS | Ce qu'il faut considérer |
| Apprentissage des applications auto-hébergées | Correspondance forte | Commencez simple, puis apprenez les chemins Docker |
| Exécution de quelques applications domestiques | Souvent un bon choix | Confirmer la persistance du stockage |
| NAS avancé multi-disques | Dépend de la configuration | Comparer les systèmes NAS dédiés |
| Virtualisation lourde | Ajustement limité | Envisagez Proxmox ou un autre hyperviseur |
| Contrôle maximal sur Docker | Dépend du niveau de compétence | Linux pur + Docker Compose peut être plus clair |
Comment passer du concept à la configuration
Une fois que vous comprenez le chemin d'installation générique, l'étape suivante est d'appliquer cette logique à un système ou appareil réel. Une configuration spécifique à l'appareil peut encore nécessiter sa propre image, mode de démarrage, processus de flash USB, cible d'installation et méthode de première connexion.
Par exemple, le guide d'installation de ZimaOS montre comment un système NAS orienté x86-64 gère le téléchargement de l'image, la création d'une clé USB bootable, les exigences de démarrage UEFI, l'installation, le redémarrage et le premier accès web. Ce type de chemin d'installation officiel est utile car il transforme le modèle général « préparer, flasher, démarrer, installer, accéder » en une séquence de configuration concrète.
Pour les utilisateurs transformant un petit serveur en environnement auto-hébergé léger, le serveur monocarte ZimaBoard 2 correspond au type de scénario d'appareil basse consommation, toujours allumé, où les services locaux, les applications Docker et l'extension de stockage deviennent souvent l'étape pratique suivante. Il doit être considéré comme une voie possible, pas la seule façon de construire un serveur domestique.
FAQ
Puis-je installer CasaOS sur n'importe quel mini PC ?
Vous pouvez installer CasaOS sur de nombreux mini PC, mais tous les appareils ne conviennent pas automatiquement. Vérifiez l'architecture CPU, la compatibilité du système de base, le stockage, le support de démarrage, et si vous pouvez accéder à la machine localement ou via SSH.
Ai-je vraiment besoin de Debian ou Ubuntu avant d'installer CasaOS ?
Dans de nombreuses configurations pour débutants, oui, vous devriez d'abord installer un système Linux de base pris en charge. CasaOS fonctionne généralement au-dessus de ce système hôte, donc le système de base gère le démarrage, le réseau, les utilisateurs, le stockage et la gestion des paquets.
CasaOS est-il identique à un système d'exploitation NAS complet ?
Pas exactement. CasaOS fournit un tableau de bord de serveur domestique et une couche de gestion des applications, tandis que le système d'exploitation de base gère toujours le comportement système de bas niveau. Pour des pools de stockage avancés, la planification RAID ou la virtualisation, vous devrez peut-être le comparer à des systèmes plus spécialisés.
Que se passe-t-il si le lien d'installation de CasaOS est indisponible ?
Confirmez d'abord que votre serveur a accès à Internet et que
curl ou wget fonctionne. Ensuite, vérifiez la source officielle d'installation de CasaOS depuis un autre appareil avant d'essayer des copies tierces de la commande d'installation.Dois-je utiliser CasaOS, Debian pur avec Docker, ou un système NAS dédié ?
Utilisez CasaOS si vous souhaitez un tableau de bord plus simple pour démarrer avec des applications auto-hébergées. Utilisez Debian pur avec Docker si vous voulez un contrôle plus direct et êtes à l'aise pour gérer les services manuellement. Envisagez un NAS dédié ou un système de virtualisation si votre objectif principal est un stockage complexe, de nombreux disques ou une infrastructure plus lourde.
Assistance et conseils
Plus à lire

Comment déployer un LLM local sans compromettre le stockage ni les applications
Ce guide explique comment déployer en toute sécurité un LLM local sur un NAS domestique partagé ou un serveur à domicile. Il couvre les...

Que vérifier avant d’ajouter une carte graphique à un NAS domestique
Ce guide explique ce qu'il faut vérifier avant d'ajouter une carte graphique à un NAS domestique. Il couvre l'adéquation de la charge de travail,...

Quelles sont les limites locales de l’IA sur un NAS domestique ?
Ce guide explique les limites de l’IA locale sur un NAS domestique selon le type de charge de travail, les ressources matérielles et l’impact...

