Guide · Installation
Installer ODIN sur votre machine
De la machine vide au serveur de connaissances hors ligne, étape par étape. ODIN se prépare avec internet, puis fonctionne sans : suivez ce guide avec une connexion, vous la couperez à la fin.
Ce qu'il vous faut
La machine qui deviendra ODIN
- Un processeur 64 bits Intel ou AMD. Les Raspberry Pi et autres machines ARM ne sont pas prises en charge.
- 8 Go de mémoire vive conseillés.
- Un disque d'au moins 40 Go, plus la taille des contenus choisis : de 80 Mo à plusieurs dizaines de Go par pack. Prenez le plus grand possible, tout y est stocké : encyclopédies, cartes, langues de traduction, vos documents.
- Un câble réseau branché sur votre box pendant l'installation.
Pour préparer l'installation
- Un autre ordinateur (Windows, Mac ou Linux) avec internet.
- Une clé USB d'au moins 8 Go. Elle sera entièrement effacée.
Étape 1 · Télécharger Ubuntu Server
ODIN tourne sur Ubuntu Server 24.04 LTS, une version gratuite de Linux prévue pour les serveurs, sans interface graphique.
- Rendez-vous sur ubuntu.com/download/server.
- Téléchargez Ubuntu Server 24.04 LTS (fichier
.isod'environ 3 Go).
Prenez bien la version Server, pas Desktop.
Étape 2 · Créer la clé USB d'installation
Le fichier .iso ne se copie pas simplement sur la clé : il faut la rendre démarrable.
Sous Windows, avec Rufus (rufus.ie)
- Branchez la clé USB et lancez Rufus.
- Périphérique : sélectionnez votre clé. Vérifiez deux fois, elle sera effacée.
- Type de démarrage : cliquez sur SÉLECTION et choisissez le fichier
.isod'Ubuntu. - Laissez les autres réglages par défaut et cliquez sur DÉMARRER.
- Si Rufus propose un mode d'écriture, gardez Image ISO (recommandé).
Sous Mac ou Linux, avec balenaEtcher (etcher.balena.io)
- Flash from file : choisissez le fichier
.iso. - Select target : choisissez votre clé.
- Flash!
Étape 3 · Démarrer la machine sur la clé USB
- Branchez la clé USB et le câble réseau sur la future machine ODIN.
- Allumez-la en appuyant plusieurs fois sur la touche du menu de démarrage. Selon le fabricant, c'est généralement F12, F11, F10, F8 ou Échap.
- Dans la liste, choisissez votre clé USB (souvent préfixée UEFI).
- Au menu d'Ubuntu, choisissez Try or Install Ubuntu Server.
La clé n'apparaît pas ? Entrez dans le BIOS (souvent Suppr ou F2 au démarrage), désactivez Fast Boot, puis réessayez. Inutile de toucher au Secure Boot.
Étape 4 · Installer Ubuntu Server
L'installeur se pilote au clavier : flèches pour se déplacer, Entrée pour valider, Espace pour cocher, Tab pour passer au champ suivant.
4.1 Langue
Choisissez Français.
4.2 Mise à jour de l'installeur
Si l'installeur propose de se mettre à jour, choisissez Continuer sans mettre à jour.
4.3 Clavier
Choisissez votre disposition, par exemple French / French en France, ou French / Belgian en Belgique. Vérifiez en tapant quelques lettres dans le champ de test.
4.4 Type d'installation
Gardez Ubuntu Server (pas la version minimized).
4.5 Réseau
Avec le câble branché, une adresse apparaît automatiquement à côté de la carte réseau (par exemple 192.168.1.42/24). Validez Terminé.
Si aucune adresse n'apparaît, vérifiez le câble avant d'aller plus loin : ODIN a besoin d'internet pour s'installer.
4.6 Proxy et miroir
Laissez le proxy vide. Laissez le miroir proposé et attendez que le test se termine, puis validez.
4.7 Disque, étape importante
- Choisissez Utiliser un disque entier et sélectionnez le disque de la machine (le plus grand s'il y en a plusieurs : ODIN stocke tout sur le disque système).
- Décochez Configurer ce disque comme un groupe LVM.
Pourquoi : avec LVM, Ubuntu n'utilise par défaut qu'une partie du disque (souvent 100 Go), et le reste reste inaccessible à ODIN.
- L'écran récapitulatif s'affiche. Vérifiez que la partition montée sur
/occupe presque tout le disque, puis Terminé. - Confirmez l'effacement du disque avec Continuer.
4.8 Profil
- Votre nom : ce que vous voulez.
- Nom du serveur :
odin. L'installeur d'ODIN renommera de toute façon la machine enodinà l'étape 6. - Nom d'utilisateur : court et en minuscules, par exemple
odin. - Mot de passe : notez-le, il servira à administrer la machine.
4.9 Ubuntu Pro
Choisissez Ignorer pour le moment.
4.10 SSH
Cochez Installer le serveur OpenSSH. Il permet d'administrer ODIN depuis un autre ordinateur, sans écran ni clavier branchés dessus.
4.11 Snaps
Ne cochez rien, en particulier pas Docker : l'installeur d'ODIN s'en charge lui-même.
4.12 Fin de l'installation
L'installation dure de 5 à 20 minutes. Quand Redémarrer maintenant apparaît, choisissez-le, retirez la clé USB quand c'est demandé et appuyez sur Entrée.
Étape 5 · Premier démarrage
- Au démarrage, l'écran affiche
odin login:. Tapez votre nom d'utilisateur, puis votre mot de passe (rien ne s'affiche pendant la saisie, c'est normal). - Mettez le système à jour :
sudo apt update && sudo apt upgrade -y- Notez l'adresse de la machine :
hostname -ILe premier nombre affiché (par exemple 192.168.1.42) est l'adresse de votre ODIN sur le réseau.
Conseil : dans l'interface de votre box, réservez cette adresse à la machine ODIN (« bail DHCP statique » ou « adresse IP fixe »). Elle ne changera plus et vous la retrouverez toujours au même endroit.
Travailler depuis un autre ordinateur : grâce à SSH, vous pouvez faire la suite depuis votre PC habituel, en ouvrant un terminal (PowerShell sous Windows) et en tapant ssh odin@192.168.1.42 (remplacez par votre nom d'utilisateur et votre adresse).
Étape 6 · Installer ODIN
Une seule commande :
curl -fsSL https://raw.githubusercontent.com/Gorgo126/ODIN/main/install.sh | sudo bashL'installeur télécharge et configure tout : Docker, les services d'ODIN, le moteur de la recherche avancée, la traduction français-anglais et le fond de carte mondial. Il nomme aussi la machine odin sur le réseau. Comptez de 5 à 30 minutes selon votre connexion, et ne fermez pas le terminal pendant l'opération.
À la fin, il affiche les adresses où ouvrir ODIN, sous la forme http://192.168.1.42, et rappelle de choisir le mot de passe à la première visite.
Étape 7 · Premier accès
- Sur n'importe quel appareil connecté au même réseau (ordinateur, téléphone, tablette), ouvrez un navigateur.
- Tapez l'adresse affichée par l'installeur, par exemple
http://192.168.1.42. Sur beaucoup d'appareils,http://odin.localfonctionne aussi. - À la première visite, ODIN vous demande de choisir un mot de passe (8 caractères au moins), de le confirmer, puis de cliquer sur Définir le mot de passe. C'est le seul mot de passe d'ODIN : il protège l'accès à tous les services, sauf le mur de messages, ouvert à tout le réseau local par le lien Mur de messages sous le formulaire. Notez-le.
Étape 8 · Installer les contenus
ODIN arrive vide. C'est maintenant, tant que vous avez internet, qu'il faut le remplir.
- Ouvrez Configuration, puis le panneau Encyclopédie.
- Dans Ajouter du contenu, cliquez sur Installer pour chaque pack voulu : Wikipédia, médecine, Wiktionnaire, etc. Le bloc Stockage, en haut de la page, indique la place encore disponible.
- Ajoutez aussi, selon vos besoins :
- les cartes des régions qui vous intéressent, dans le panneau Cartes ;
- des langues de traduction, dans le panneau Traduction ;
- les fiches Comment faire ? : sur l'accueil d'ODIN, ouvrez la carte Comment faire ? et cliquez sur Installer les articles.
Les téléchargements peuvent être longs. Une interruption n'est pas grave : le téléchargement reprend là où il s'était arrêté.
Vous pouvez aussi déposer vos propres documents dans Documents personnels : notices, papiers importants, plans, recettes.
Étape 9 · Couper internet
ODIN est prêt. Débranchez-le d'internet : tout continue de fonctionner.
Les appareils doivent simplement rester sur le même réseau local que la machine ODIN. Votre box continue de faire ce réseau même quand internet est coupé. Sans box, ODIN peut créer son propre réseau Wi-Fi : voir le point d'accès Wi-Fi, une option encore expérimentale.
Mettre à jour ODIN
Rebranchez internet et relancez la même commande qu'à l'étape 6. Elle met ODIN à jour sans toucher à vos contenus, vos documents ni votre mot de passe.
Les fiches Comment faire ? se mettent à jour à part : Configuration, panneau Comment faire ?, Vérifier les mises à jour, puis Mettre à jour.
En cas de problème
J'ai oublié le mot de passe d'ODIN
- Connectez-vous à la machine ODIN : directement, avec un écran et un clavier, ou depuis un autre ordinateur avec
ssh(étape 5). - Supprimez le fichier du mot de passe :
sudo rm /opt/odin/data/config/auth.json- Rouvrez ODIN dans un navigateur immédiatement : il vous demande de choisir un nouveau mot de passe, comme à la première visite. Aucun redémarrage n'est nécessaire.
La page ne s'ouvre pas
Vérifiez que l'appareil est bien sur le même réseau que la machine ODIN, et que vous tapez http:// et non https://. Si odin.local ne répond pas, utilisez l'adresse numérique.
La machine a changé d'adresse
Connectez un écran à la machine et tapez hostname -I, puis réservez l'adresse dans votre box (étape 5).
