English | Deutsch | 中文

🔴 BOOT — déploiement et provisionnement

À quoi ça sert. Choisir la bonne façon de mettre SecuBox sur une machine : une clé USB live pour l'essayer, un installateur sans écran pour dédier un PC, une image prête pour une carte, une machine virtuelle, ou le dépôt APT sur un Debian existant. SecuBox tourne sur Debian 13 (Trixie) depuis l'alpha 9 (voir Trixie).

Préversion. La ligne actuelle est v3.0.0-alpha.12 (octobre 2026). À essayer sur une box de test, pas sur la connexion dont dépend la maison.

Les noms d'image suivent secubox-<profil>-<carte>-<suite>. Vérifiez toujours la page de la release pour ce qu'elle livre.

Les grosses images sont coupées en morceaux de 1900 Mo au plus. Les réunir, puis décompresser :

cat secubox-full-vm-x64-trixie.img.gz.part* > secubox-full-vm-x64-trixie.img.gz
gunzip secubox-full-vm-x64-trixie.img.gz

sha256sum -c SHA256SUMS --ignore-missing

Vaut pour toute image .img.gz (live, cartes). Remplacez /dev/sdX par votre clé USB ou carte SD, après vérification avec lsblk : tout ce qui se trouve sur ce périphérique est effacé.

lsblk
zcat secubox-live-amd64-trixie.img.gz | sudo dd of=/dev/sdX bs=4M status=progress
sync

Sous Windows, extraire l'.img et l'écrire avec un outil comme Rufus ou balenaEtcher. Une image .img.xz se lit avec xzcat au lieu de zcat. Détails pour la clé live : Live-USB-FR.

secubox-installer-amd64-trixie démarre, puis installe SecuBox sur le premier disque adapté, sans écran ni clavier. Écrivez l'.img.gz sur une clé USB avec dd (ci-dessus), ou utilisez le fichier d'image .iso.gz.

Il efface ce disque. L'installateur choisit le premier disque interne non amovible dans cet ordre : /dev/nvme0n1, /dev/sda, /dev/vda, /dev/xvda, en écartant le disque sur lequel il a démarré. Sans terminal attaché, il attend 5 secondes puis continue sans rien demander. Débranchez tout disque à conserver avant de le démarrer.

1. Démarrer la clé en mode UEFI ou BIOS.
2. Dans le menu GRUB, choisir SecuBox Install (Headless Auto-Install). Les autres entrées sont le système live (par défaut, délai de 10 s), sans persistance, en RAM, mode sans échec et shells de débogage.
3. La machine partitionne le disque (EFI, racine, données), copie le système et redémarre. Retirez la clé au redémarrage.
4. Joindre l'interface web (voir « Premier démarrage »).

Un passage interactif (avec confirmation) est aussi possible depuis le système live : sudo secubox-installer. L'image live a aussi un installateur de disque (entrée « Install SecuBox to Disk », qui liste les disques et laisse choisir).

Le plus rapide, depuis un clone du dépôt :

git clone https://github.com/CyberMind-FR/secubox-deb.git
cd secubox-deb
./image/create-vbox-vm.sh --download        # dernière release, crée et démarre la VM

Options utiles : --download <tag> (par exemple v3.0.0-alpha.12), --name, --memory (4096 Mo par défaut), --cpus (4 par défaut), --bridge <interface de l'hôte> (pont au lieu du NAT), --headless, --no-start, --force. En NAT, l'hôte redirige 2222 -> 22 (SSH), 9443 -> 443 (HTTPS) et 8080 -> 80 (HTTP).

VirtualBox ne lance que des images amd64 ; les images ARM64 passent par QEMU (create-qemu-arm64-vm.sh, voir QEMU-ARM64). Pages pas à pas : Live-USB-VirtualBox, Live-USB-QEMU, VirtualBox-Setup.

curl -fsSL https://apt.secubox.in/install.sh | sudo bash
sudo apt install secubox-lite      # ou secubox-isp, secubox-full

Installation manuelle : poser la clé du dépôt dans un trousseau et déclarer la suite trixie (arm64 et amd64 sont publiés) :

curl -fsSL https://apt.secubox.in/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/secubox-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/secubox-archive-keyring.gpg] https://apt.secubox.in trixie main" \
  | sudo tee /etc/apt/sources.list.d/secubox.list
sudo apt update
sudo apt install secubox-full

La suite bookworm n'évolue plus.

Composition complète : Profils. Sur une ESPRESSObin, secubox-install-emmc copie le système en marche de la microSD vers l'eMMC et refuse clairement si cela ne tient pas.

1. Ouvrir https://<adresse de la box>/ (pour une VM VirtualBox en NAT : https://localhost:9443). Le certificat est auto-signé : vérifiez que le nom ou l'adresse est bien celui de la machine que vous venez d'installer avant de l'accepter.
2. Se connecter en admin. Le mot de passe d'amorçage est secubox, sauf si un fichier /boot/admin_password a été fourni avant le premier démarrage ; le compte est marqué pour imposer un changement à la première connexion. Choisissez une phrase de passe longue et unique.
3. Une box neuve lance l'assistant du premier démarrage (nom, horloge, administrateur, réseau, profil, maillage, mises à jour) : First-Boot-Premier-Pas-FR.
4. Régler le fuseau et le nom de la machine, remplacer le certificat d'amorçage avant toute exposition au réseau, et prendre un premier instantané.

Accès perdu sur la console : sudo secubox-passwd réinitialise le compte du portail.

• Live-USB-FR - essayer sans installer
• Trixie - la base Debian 13 et la mise à jour 12 vers 13
• Auto-Load-FR - des boxes qui se mettent en service seules
• First-Boot-Premier-Pas-FR - l'assistant du premier démarrage
• Netboot-Install - installer par le réseau
• ARM-Installation-FR - cartes et U-Boot
• Configuration-FR - réglages du système
• Troubleshooting-FR