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.

  1. Rendez-vous sur ubuntu.com/download/server.
  2. Téléchargez Ubuntu Server 24.04 LTS (fichier .iso d'environ 3 Go).

Prenez bien la version Server, pas Desktop.

Page de téléchargement d'Ubuntu Server, bouton de téléchargement 24.04 LTS
Page de téléchargement d'Ubuntu Server, bouton de téléchargement 24.04 LTS

É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)

  1. Branchez la clé USB et lancez Rufus.
  2. Périphérique : sélectionnez votre clé. Vérifiez deux fois, elle sera effacée.
  3. Type de démarrage : cliquez sur SÉLECTION et choisissez le fichier .iso d'Ubuntu.
  4. Laissez les autres réglages par défaut et cliquez sur DÉMARRER.
  5. Si Rufus propose un mode d'écriture, gardez Image ISO (recommandé).
Fenêtre de Rufus avec l'ISO sélectionnée
Fenêtre de Rufus avec l'ISO sélectionnée

Sous Mac ou Linux, avec balenaEtcher (etcher.balena.io)

  1. Flash from file : choisissez le fichier .iso.
  2. Select target : choisissez votre clé.
  3. Flash!
BalenaEtcher prêt à écrire
BalenaEtcher prêt à écrire

Étape 3 · Démarrer la machine sur la clé USB

  1. Branchez la clé USB et le câble réseau sur la future machine ODIN.
  2. 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.
  3. Dans la liste, choisissez votre clé USB (souvent préfixée UEFI).
  4. 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.

Menu de démarrage du BIOS avec la clé USB
Menu de démarrage du BIOS avec la clé USB
Écran GRUB « Try or Install Ubuntu Server »
Écran GRUB « Try or Install Ubuntu Server »

É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.

Choix de la langue
Choix de la langue

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.

Configuration du clavier
Configuration du clavier

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.

Écran réseau avec l'adresse obtenue automatiquement
Écran réseau avec l'adresse obtenue automatiquement

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

  1. 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).
  2. 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.

Écran « Configuration du stockage » avec LVM décoché
Écran « Configuration du stockage » avec LVM décoché
  1. L'écran récapitulatif s'affiche. Vérifiez que la partition montée sur / occupe presque tout le disque, puis Terminé.
  2. Confirmez l'effacement du disque avec Continuer.
Récapitulatif du stockage, partition / sur tout le disque
Récapitulatif du stockage, partition / sur tout le disque

4.8 Profil

  • Votre nom : ce que vous voulez.
  • Nom du serveur : odin. L'installeur d'ODIN renommera de toute façon la machine en odin à l'étape 6.
  • Nom d'utilisateur : court et en minuscules, par exemple odin.
  • Mot de passe : notez-le, il servira à administrer la machine.
Écran de profil rempli
Écran de profil rempli

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.

Écran SSH avec OpenSSH coché
Écran SSH avec OpenSSH coché

4.11 Snaps

Ne cochez rien, en particulier pas Docker : l'installeur d'ODIN s'en charge lui-même.

Liste des snaps, rien de coché
Liste des snaps, rien de coché

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.

Écran « Installation terminée »
Écran « Installation terminée »

Étape 5 · Premier démarrage

  1. 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).
  2. Mettez le système à jour :
sudo apt update && sudo apt upgrade -y
  1. Notez l'adresse de la machine :
hostname -I

Le premier nombre affiché (par exemple 192.168.1.42) est l'adresse de votre ODIN sur le réseau.

Terminal après connexion, résultat de hostname -I
Terminal après connexion, résultat de hostname -I

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 bash

L'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.

Terminal pendant l'installation
Terminal pendant l'installation
Message de fin d'installation avec l'adresse
Message de fin d'installation avec l'adresse

Étape 7 · Premier accès

  1. Sur n'importe quel appareil connecté au même réseau (ordinateur, téléphone, tablette), ouvrez un navigateur.
  2. Tapez l'adresse affichée par l'installeur, par exemple http://192.168.1.42. Sur beaucoup d'appareils, http://odin.local fonctionne aussi.
  3. À 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.
Page de création du mot de passe
Page de création du mot de passe
Accueil d'ODIN après connexion
Accueil d'ODIN après connexion

Étape 8 · Installer les contenus

ODIN arrive vide. C'est maintenant, tant que vous avez internet, qu'il faut le remplir.

  1. Ouvrez Configuration, puis le panneau Encyclopédie.
  2. 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.
  3. 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é.

Panneau Encyclopédie, choix des packs
Panneau Encyclopédie, choix des packs
Téléchargement d'un pack en cours
Téléchargement d'un pack en cours

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

  1. Connectez-vous à la machine ODIN : directement, avec un écran et un clavier, ou depuis un autre ordinateur avec ssh (étape 5).
  2. Supprimez le fichier du mot de passe :
sudo rm /opt/odin/data/config/auth.json
  1. 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).

Retour à l'accueil