Documentation de LGM-OS
10 min · 6 rubriques
Toute la documentation du NAS, classée selon le moment où tu en auras besoin. Si tu viens d’installer, commence par le guide d’administration ; les autres sont des guides thématiques qui ne servent que lorsque tu t’attaques à ce sujet précis.
Pour commencer
| Guide | À quoi il sert |
|---|---|
| Installer le NAS de zéro | La toute première étape, avec des captures de chaque écran : télécharger l’image, graver la clé USB sous Windows, Mac ou Linux, démarrer le dispositif dessus et l’installation —qui ne demande rien—. Et que faire si le dispositif ne démarre pas sur la clé ou si quelque chose bloque. |
| Guide d’administration | Commence par « Les dix premières minutes » : le chemin complet entre le moment où tu allumes le dispositif et celui où tu as des disques, des dossiers, des comptes et une sauvegarde qui sert vraiment. Ensuite, le manuel du quotidien, sujet par sujet. Si tu n’en lis qu’un, c’est celui-ci. |
| Avoir le panneau comme application | Le panneau sur le téléphone, la tablette ou l’ordinateur avec son icône et sans la barre du navigateur : le certificat de ton NAS —l’étape que presque tout le monde saute— et les deux étapes, dispositif par dispositif (iPhone, Android, Windows, Mac et Linux). Et ce que veut dire chaque chose bizarre : le raccourci sans logo, celui qui s’ouvre tout blanc. |
| LGM Connect, l’application | Le NAS dans une fenêtre de ton ordinateur : le panneau entier —les mêmes apps, tes autorisations— plus ce qu’une page web ne peut pas faire. Tes dossiers comme un lecteur de plus (même hors connexion), les alertes du NAS dans le centre de notifications et les caméras dans leur propre fenêtre. L’installer, trouver ton NAS de quatre façons et que faire quand quelque chose ne se connecte pas. |
| Installer LGM Connect sur l’iPhone | L’application sur l’iPhone sans passer par l’App Store : le fichier .ipa signé par toi avec ton propre identifiant Apple et Sideloadly. Le mot de passe pour les apps, le « Faire confiance » sur lequel tout le monde bloque, pourquoi la signature dure 7 jours et comment la renouveler en une minute. Et ce que ce chemin ne donne pas : les alertes. |
| Si LGM-OS disparaît | La question à se poser avant de confier les photos de ta famille à un produit payant fait par une seule personne : si le projet s’arrête, le code est publié et la licence n’est plus demandée. Et ce qui se passe aujourd’hui si le serveur tombe, dans quel format sont tes données et ce que ton NAS raconte à lgm-os.com. Avec les commandes pour le vérifier toi-même. |
| Connecter tes dispositifs | Que le NAS apparaisse comme un dossier de plus sous Windows, Mac, Linux, sur l’iPhone et Android : quoi taper sur chacun, quel protocole utiliser pour quoi, et pourquoi SMB n’est jamais publié sur internet. |
| Utilisateurs et autorisations | Qui voit quoi : les quatre couches (le compte, les applications, les dossiers et les protocoles), les trois niveaux de chaque app, le Panneau de configuration écran par écran, les groupes et ce qui se passe exactement quand on supprime le compte de quelqu’un. |
| README du projet | Ce qu’est LGM-OS, comment l’installer depuis l’ISO ou sur un Debian existant, comment le mettre à jour (sans avoir besoin d’accéder au code) et quelles limites il a aujourd’hui. |
Guides par sujet
| Guide | À quoi il sert |
|---|---|
| Sauvegardes | Sortir tes données du NAS avant qu’il n’arrive quelque chose : quels dossiers copier, où (disque, autre serveur par SSH ou le cloud) et à quelle fréquence, comment autoriser pas à pas la clé SSH de la destination distante et —la seule chose qui n’est pas facultative— comment vérifier, en restaurant pour de vrai, que la sauvegarde sert. |
| Protection contre les rançongiciels | Que les sauvegardes soient toujours là quand quelqu’un chiffre le NAS : ce qui protège vraiment et ce qui ne protège pas, le cadenas des instantanés (la seule chose qui empêche de les supprimer, même pour root) et que faire dans les dix premières minutes si c’est déjà arrivé. |
| Caméras | La vidéosurveillance sur le NAS lui-même : trouver les caméras du réseau par ONVIF, les ajouter quand elles ne l’ont pas, combien de disque chacune consomme et pourquoi il ne faut pas ouvrir leur port sur le routeur. |
| Accès depuis internet | Atteindre le NAS depuis l’extérieur en le publiant avec ton propre domaine : DDNS avec DuckDNS, certificat Let's Encrypt, proxy inverse par sous-domaine et la liste de sécurité à respecter avant de toucher au routeur. |
| Services réseau | Faire du NAS le centre du réseau : VPN WireGuard (la façon la plus sûre d’entrer depuis l’extérieur, sans rien exposer), Tailscale et NetBird pour quand tu ne peux pas ouvrir de ports, serveur DNS avec des noms locaux et serveur DHCP. Avec la façon de récupérer le réseau si le DHCP te laisse sans connexion : lis-le avant de l’activer et garde-le sur ton téléphone. |
| Disques, secours et réplications | Tirer parti des disques une fois le volume créé : cache de lecture, disque de secours qui prend le relais tout seul quand un autre tombe en panne, réplication du volume entier vers un autre NAS, disques réseau (iSCSI) pour Windows, Proxmox ou VMware et les disques USB que tu branches un moment. |
| Fichiers | Le gestionnaire de fichiers complet : aperçu des documents, photos et notes sans rien télécharger, recherche instantanée (y compris à l’intérieur des fichiers), liens de téléchargement avec expiration et mot de passe, demander des fichiers à quelqu’un qui n’a pas de compte, la corbeille partagée avec le PC et les versions que gardent les instantanés. |
| Galerie | Photos et vidéos en chronologie et en albums sans rien déplacer : favorites, Live Photos, HEIC et RAW, doublons, et chaque compte ne voit que les siennes. |
| IA locale | Interroger le NAS comme une personne : ce qu’elle vérifie avant de répondre, les trois modes (discuter seulement, copilote et autonome), ce qu’elle ne fait jamais sans demander, la faire programmer dans tes projets sans sortir du dossier, l’IA de chaque compte et connecter d’autres apps. |
| Chat | Parler avec les personnes de la maison, à deux ou en groupe : passer un fichier sans donner le dossier, des messages qui expirent et ce que le chat n’est pas (ce n’est pas un chiffrement de bout en bout). |
| Documents | Regarder n’importe quel document bureautique converti en PDF sans rien installer, et le modifier dans le navigateur avec l’éditeur qui s’installe tout seul la première fois — et qui ne voit jamais tes disques. |
| Centre de paquets et conteneurs | Installer des applications en un clic et tout ce qu’il y a dessous : 31 apps maison et plus de 3 000 de la communauté, les ports et dossiers de chacune, la modification avancée avec retour en arrière automatique, désinstaller en sachant ce qu’il advient des données, journaux, console et nettoyage. |
| Machines virtuelles | Un autre ordinateur dans le NAS, depuis le navigateur : l’installer depuis son ISO, son écran, lui donner sa propre IP avec un pont, des instantanés avec la mémoire, agrandir le disque, lui confier un périphérique USB du NAS, l’emporter vers un autre NAS et les trois conditions de Windows 11. |
| Services de la maison | Ce que presque tout le monde paie ailleurs et qui tient dans le dispositif déjà allumé : téléchargements (liens, magnet et .torrent), la télé par DLNA, agenda et contacts sur le NAS, imprimante réseau et synchronisation avec le cloud. |
| Bloc-notes | Écrire SUR le NAS, pas seulement stocker : modifier n’importe quel fichier texte, le carnet de notes liées (avec [[liens]], graphe, étiquettes et tâches) et l’éditeur de code avec coloration syntaxique pour des dizaines de langages. |
| Surveiller et défendre les données | Les six pièces qui veillent sur ce qui est stocké : versions précédentes dans Windows même, qui a touché à quoi, antivirus, piège anti-rançongiciel, blocage par pays et rapport hebdomadaire. |
| Énergie | Éteindre le NAS la nuit et le faire redémarrer tout seul le matin, Wake-on-LAN, mettre les disques en veille et l’onduleur — le sien, celui qu’il partage avec le reste de la maison ou celui d’un autre dispositif. |
Quand quelque chose ne va pas
| Guide | À quoi il sert |
|---|---|
| Quand quelque chose ne marche pas | Classé selon ce que tu vois, pas selon ce qui tombe en panne : le panneau ne s’ouvre pas, je ne vois pas le NAS sur le réseau, il est lent, un disque donne des erreurs, j’ai mis à jour et quelque chose s’est cassé, le disque est plein, « Le réglage … était endommagé » (et comment le récupérer si personne ne peut entrer). Et quelles informations sont nécessaires pour qu’on puisse t’aider. |
| Reprise après sinistre | Quand c’est déjà arrivé : disque en panne, réinstaller en gardant les données, restaurer depuis un instantané ou depuis la sauvegarde externe. |
Référence
| Document | À quoi il sert |
|---|---|
| Référence des ports | Ce qui écoute sur chaque port, qui l’ouvre et —ce qui compte vraiment— lequel on peut ouvrir sur le routeur et lequel ne s’ouvre jamais. |
| Glossaire | Chaque mot bizarre qui apparaît dans le panneau et dans ces guides, en une phrase : RAID, instantané, scrub, SMART, ACL, DDNS, Object Lock, jeton, WOL… |
| CHANGELOG | Ce qui a changé dans chaque version, avec les avertissements de celles qui demandent de l’attention lors de la mise à jour. |
| allowlist.py | La liste fermée des commandes et chemins qu’accepte le processus privilégié. C’est la source de vérité sur ce que le panneau peut et ne peut pas faire sur le système. |
Comment choisir la voie d’accès à distance
C’est la décision qui soulève le plus de doutes, et les deux guides concernés se lisent mieux en sachant ceci :
- Seulement toi et tes dispositifs → VPN du guide des services réseau. Ne publie rien sur internet : tu ouvres un port UDP sur le routeur et, depuis ton téléphone ou ton portable, tu entres dans tout le réseau local, pas seulement dans le panneau. C’est l’option la plus sûre et celle qui est recommandée. Si tu ne peux pas ouvrir de ports, Tailscale ou NetBird font la même chose sans en ouvrir aucun.
- Partager avec d’autres personnes (famille, invités, une app qui doit être accessible sans rien installer) → Accès depuis internet. Publie le NAS avec un certificat valide et Apache comme seul service exposé, et exige de respecter d’abord la liste de sécurité de ce guide.
Les deux peuvent coexister sans se gêner.
Conventions
- Les commandes qui commencent par
sudos’exécutent dans la console du NAS (physiquement, par SSH ou depuis le terminal web du panneau). - Les chemins du panneau s’écrivent
App → Section → Onglet, par exemplePanneau de configuration → VPN. - Les blocs marqués ⚠️ décrivent des opérations qui peuvent te laisser sans accès au NAS ou sans réseau. Lis-les en entier avant de les exécuter.