HASHFORGE OS — image USB

Ubuntu 26.04 AMD64 léger pour rigs de mining / IA, dans l'esprit de HiveOS. C'est un vrai système installé sur la clé (pas un live Casper) : tout reste après un redémarrage.

Flasher

1. Télécharge hashforge-os-<version>-amd64.img.zip dans les releases.
2. Écris-le sur une clé USB (8 Go minimum) avec balenaEtcher ou Rufus (mode image DD). Linux : unzip -p hashforge-os-*.img.zip | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync.
3. Démarre le rig sur la clé : BIOS ou UEFI, Secure Boot accepté (shim signé Ubuntu).

Au 1er démarrage, le système s'agrandit à toute la clé, puis l'assistant HASHFORGE (mode texte, avant le bureau) demande : clavier (AZERTY FR par défaut), nom du rig, compte administrateur, réseau DHCP ou IP fixe, SSH, ouverture automatique du bureau.

Sans écran (comme le rig.conf de HiveOS) : sur la partition HF-EFI de la clé (visible sous Windows), copie hashforge-setup.example.txt en hashforge-setup.txt et remplis-le. Le rig se configure seul et le fichier est effacé ensuite.

Tester sous Windows avec VirtualBox

1. Télécharge hashforge-os-<version>-amd64.vdi.zip dans les releases et dézippe-le.
2. VirtualBox → Nouvelle VM : type Linux, Ubuntu (64-bit), 4 Go de RAM, 2 CPU, sans disque.
3. Configuration → Stockage : ajoute le .vdi sur le contrôleur SATA. Affichage : VMSVGA, 128 Mo. EFI activé ou non, les deux marchent.
4. Démarre : GRUB HASHFORGE, puis l'assistant de premier démarrage.

Contenu

• Noyau Ubuntu générique + linux-firmware (AMD/NVIDIA/Intel), GRUB BIOS+UEFI au thème HASHFORGE, Plymouth animé (logo, points orange, barre de progression).
• Bureau Xfce sombre, fond HASHFORGE, LightDM, NetworkManager. Pas de snap, pas de paquets recommandés inutiles.
• Léger : ~575 paquets, 1,7 Go installé (image zip < 1 Go). Pas de docs, pages man, langues autres que FR/EN, ni firmwares de serveurs/routeurs (Qualcomm, Mellanox…). Les firmwares GPU et cartes réseau courantes restent. Les headers du noyau s'installent à la demande (nvidia-install, build-tools).
• Aucun mineur installé.
• Terminal HASHFORGE-OS : help (toutes les commandes), hashforge (menu type HiveOS), hf-anim intro|rain|forge|gpu (animations). Commandes : nvidia-install, nvidia-update, cuda-install, amd-install, go-install, rust-install, python-install, node-install, docker-install, nvidia-container-install, build-tools, ollama-install, llama-build, vllm-install, net-setup, ssh-setup, rig-name, kb-setup, disk-grow, gpu-watch, temps, sys-info…

Installer sur un disque (comme HiveOS)

Au demarrage sur la cle, si le PC a un disque d'au moins 8 Go, HASHFORGE OS demande : lancer depuis la cle (defaut apres 30 s), installer sur un disque ou ne plus demander. On choisit le disque, on confirme deux fois (le disque est EFFACE), la cle est copiee avec le compte et les reglages, le disque est rendu demarrable (BIOS + UEFI) et le PC redemarre dessus : retirer la cle. A tout moment : sudo hashforge-install-disk (ou --list, --disk /dev/sdX --yes).

Mettre a jour un rig deja installe

Pas besoin de refaire la cle : hashforge-update installe la derniere release de ce depot (terminal, scripts, themes). Le compte, le reseau, le clavier et SSH ne sont pas touches.

hashforge-update --check     # version installee / disponible
hashforge-update             # met a jour
hashforge-update --auto off  # coupe la verification automatique (1 fois par jour)

Cle 1.0.2 ou plus ancienne (pas encore de hashforge-update), une seule fois :

curl -fsSL https://git.avisflow.online/aque/hashforge-os-image/raw/branch/main/scripts/bootstrap-update.sh | sudo bash

Choisir les versions

Chaque installateur ouvre un menu des versions officielles (recommandee en tete), accepte une version precise et --list : nvidia-driver, nvidia-install 580 --closed, cuda-install 12.8, go-install 1.22, rust-install 1.75.0, python-install 3.11, node-install 20, docker-install 27.5, ollama-install, vllm-install, llama-build b5000, amd-install 6.4.1.

Venv Python

cd ~/crypto && venv-create 3.11   # cree .venv et l'active (alias venvcreate)
venv-on / venv-off                # active (aussi depuis un sous-dossier) / desactive (alias venvactivate)
venv-list / venv-rm               # liste les venvs / supprime celui du dossier

Construire

Sur Ubuntu (ou WSL2) avec Docker : ./build.sh → out/hashforge-os-<version>-amd64.img.zip (clé USB, 6 Go, s'agrandit au 1er boot) et .vdi.zip (VirtualBox). HF_SIZE=8G ./build.sh pour changer la taille, HF_MIRROR=http://fr.archive.ubuntu.com/ubuntu pour le miroir.

Dossier	Rôle
scripts/build-image.sh	partitions GPT (BIOS boot + EFI + racine), debootstrap, chroot, compression
scripts/chroot-setup.sh	paquets, langue/clavier FR, branding, GRUB, Plymouth, services
overlay/	fichiers copiés tels quels dans le système (thèmes, Xfce, LightDM, services)
terminal/	terminal HASHFORGE (forge, commandes, menu, animations)
firstboot/	assistant de premier démarrage
assets/	images sources et images générées (fond, GRUB, logo)

Ajouter une commande : un fichier terminal/lib/forge/commands/<nom>.sh avec les en-têtes # DESC:, # CAT:, # ROOT:, # USAGE: et une fonction main. help et le menu la trouvent tout seuls.