Guide d'installation et flashage USB

26 April 2026

Guide d’installation et flashage USB

Ce guide vous permet de demarrer avec Magic Stick en quelques minutes : telecharger l’ISO, la flasher sur une cle USB, et booter.

Telecharger l’ISO

L’ISO est disponible sur SourceForge (ISO brute, prete a flasher) :

Prerequis

  • Une cle USB de 32 Go minimum (64 Go recommande)

  • Un PC pour flasher la cle

Methode 1 : balenaEtcher (recommandee)

balenaEtcher est un outil graphique simple pour flasher une ISO sur une cle USB. Il fonctionne sous Windows, macOS et Linux.

Etape 1 : Installer balenaEtcher

  1. Rendez-vous sur balena.io/etcher

  2. Telechargez la version pour votre OS

  3. Installez et lancez balenaEtcher

Etape 2 : Flasher l’ISO

  1. Cliquez sur "Flash from file"

  2. Selectionnez le fichier magic-stick_0.1.8.iso

  3. Cliquez sur "Select target" et choisissez votre cle USB

  4. Cliquez sur "Flash!"

  5. Attendez la fin de l’operation (verification comprise)

Caution

balenaEtcher va effacer toutes les donnees de la cle USB. Verifiez bien le peripherique selectionne.

Etape 3 : Booter sur la cle

  1. Laissez la cle USB inseree

  2. Redemarrez le PC

  3. Accedez au BIOS/UEFI en tapant F2, F12 ou Suppr au demarrage

  4. Selectionnez la cle USB dans le menu de boot

  5. Le systeme live Xubuntu se lance

Note

Sur la plupart des PC recents, le menu de boot s’accede avec F12. Sur les PC plus anciens, essayez F2 ou Suppr pour entrer dans le BIOS, puis changez l’ordre de boot.

Methode 2 : dd en ligne de commande (Linux)

Cette methode est pour les utilisateurs Linux à l’aise avec le terminal.

Etape 1 : Identifier la cle USB

lsblk

Reperez votre cle USB (par exemple /dev/sdb). Verifiez bien le device : une erreur peut effacer votre disque systeme.

Etape 2 : Flasher l’ISO

sudo dd if=magic-stick_0.1.8.iso of=/dev/sdX bs=4M status=progress && sync

Remplacez /dev/sdX par le device de votre cle USB.

Caution

Cette commande est destructrice. Elle efface toutes les donnees du peripherique cible. Verifiez deux fois le device avec lsblk.

Etape 3 : Booter sur la cle

  1. Inserez la cle USB dans le PC cible

  2. Redemarrez et accedez au BIOS/UEFI (F2, F12 ou Suppr)

  3. Selectionnez la cle USB dans le menu de boot

  4. Le systeme live Xubuntu se lance

Methode 3 : Script flash.sh (Linux)

Le depot Magic Stick inclut un script de flashage automatise :

# Cloner le depot
git clone https://github.com/cheroliv/magic-stick.git
cd magic-stick

# Identifier la cle USB
lsblk

# Flasher (REMPLACEZ /dev/sdX par votre device)
sudo scripts/flash.sh /dev/sdX

Le script :

  1. Verifie que le device est un peripherique bloc

  2. Trouve l’ISO la plus recente dans build/

  3. Demande une confirmation (YES) avant d’effacer

  4. Demonte les partitions montees

  5. Ecrit l’ISO avec dd (bs=4M, conv=fsync)

  6. Synchronise avec sync

Verifier l’ISO (optionnel)

Avant de flasher, vous pouvez verifier l’integrite de l’ISO :

#Verifier le checksum SHA256
sha256sum magic-stick_0.1.8.iso

Comparez le resultat avec le fichier .sha256 fourni sur SourceForge.

Premier boot

Au premier demarrage de Magic Stick :

  • Utilisateur : magic (connexion automatique)

  • Clavier : FR (AZERTY)

  • Locale : fr_FR.UTF-8

  • Bureau : Xubuntu XFCE

Vous pouvez installer des logiciels complementaire avec install-software.sh :

# Installer Docker
sudo install-software.sh docker

# Installer Ollama
sudo install-software.sh ollama

# Installer SDKMAN + JDK 21
sudo install-software.sh sdkman

Prochaines etapes