Configurer IOTA Train at Home sur Mac : le guide complet

Vous découvrez tout juste Train at Home ? Commencez par ce qu'est vraiment IOTA Train at Home si vous voulez le contexte d'abord. Ce guide suppose que vous le savez déjà, et se concentre sur une seule question : comment configurer un Mac pour qu'il contribue de façon stable, sans avoir à le surveiller chaque jour ?

Ce que « optimal » veut dire ici

Il n'existe ni fiche de configuration minimale officielle, ni seuil de débit publié à atteindre. Les deux sources officielles qui comptent — la FAQ Train at Home↗ et le guide utilisateur Train at Home↗ — restent toutes deux qualitatives : « Une connexion internet stable aide votre ordinateur à rester connecté au réseau et à renvoyer les résultats. Si votre connexion coupe souvent, votre contribution peut être plus faible, ce qui est normal », et « Gardez l'ordinateur portable branché et sur un réseau stable pour des récompenses régulières ».

Ici, « optimal » ne veut donc pas dire la ligne la plus rapide possible ou le Mac le plus puissant. Cela veut dire de la disponibilité et de la stabilité : un Mac qui reste allumé, qui reste connecté, et qui laisse l'application officielle tourner sur de longues périodes sans interruption. Tout ce qui suit est organisé autour de cette priorité, dans l'ordre où elle compte généralement le plus.

Prérequis

• macOS. Train at Home ne prend actuellement en charge que macOS (le support Linux est annoncé comme « à venir » dans le guide utilisateur officiel). Ce guide et subnera ont été vérifiés pour la dernière fois avec macOS 26.6.2.
• L'alimentation secteur. Un portable doit rester branché, pas sur batterie — la veille et la limitation liée à une batterie faible sont les deux façons les plus discrètes d'arrêter de contribuer pendant la nuit sans s'en rendre compte.
• Une connexion réseau stable, filaire ou Wi-Fi. Les consignes officielles n'imposent pas l'Ethernet, mais une interface Wi-Fi qui coupe ou qui économise l'énergie est une cause fréquente, et facile à manquer, d'envois interrompus.

Installer et démarrer

Si vous n'avez pas encore installé l'application officielle, suivez le guide d'installation dédié étape par étape, puis revenez ici. En résumé : téléchargez l'application depuis le site officiel, ouvrez le .dmg, et attendez que l'indicateur de statut affiche « Connected » avant de faire quoi que ce soit d'autre.

Empêcher la mise en veille du Mac

C'est l'étape la plus déterminante, et celle qu'on rate le plus facilement. Train at Home ne maintient aucune revendication d'activité (« power assertion ») qui lui soit propre. Sur un Mac où le mineur tourne réellement, pmset -g assertions montre que la prévention de la mise en veille vient uniquement de démons système génériques (powerd, runningboardd) ou d'un outil séparé comme caffeinate — jamais de l'application Train at Home ni de son processus de calcul lui-même. Cela correspond exactement à la FAQ officielle : « L'entraînement s'arrête automatiquement. Rien ne continue de tourner quand l'application est fermée ou que votre ordinateur se met en veille. »

Autrement dit : l'application compte entièrement sur vous (ou sur macOS) pour garder la machine éveillée. Si rien d'autre ne maintient une revendication de veille, un Mac inactif finira par se mettre en veille, et votre contribution s'arrêtera.

Le détail complet, drapeau par drapeau, se trouve dans le guide sur la veille. En résumé, d'après man caffeinate sur ce Mac :

• -d — empêche la mise en veille de l'écran.
• -i — empêche la mise en veille du système au repos.
• -m — empêche la mise en veille du disque au repos.
• -s — empêche la mise en veille du système, mais seulement sur secteur.
• -u — déclare l'utilisateur « actif » ; sans -t, l'effet n'est que momentané.

Pour un mineur qui tourne longtemps, la combinaison pratique est :

caffeinate -dims

Laissez cette fenêtre de Terminal ouverte (ou lancez la commande en tâche de fond) aussi longtemps que vous voulez que Train at Home continue à s'entraîner. Vérifiez que la revendication est bien active avec :

pmset -g assertions
pmset -g

Si vous préférez ne pas garder une commande de Terminal en cours, l'alternative intégrée est Réglages Système → Énergie → « Empêcher la mise en veille automatique lorsque l'écran est éteint ». Ce n'est pas une fonctionnalité de Train at Home — c'est un réglage macOS général — mais le résultat est similaire, sans passer par caffeinate.

Réseau et ports : que vérifier, à quoi ne pas toucher

Train at Home communique sur le réseau de trois façons : une connexion de contrôle locale, une API sortante, et des transferts pair-à-pair. Vous n'avez besoin de configurer aucune des trois pour un usage normal, mais il est utile de savoir ce qui est normal pour distinguer un vrai problème du bruit de fond.

• 127.0.0.1:8010 est la connexion de contrôle locale entre l'application officielle et son processus de calcul — en boucle locale uniquement, jamais accessible depuis l'extérieur de votre Mac. N'exposez jamais ce port et ne vous y connectez jamais vous-même ; ce n'est pas une API publique, et l'application possède déjà la seule connexion dont elle a besoin.
• Le HTTPS sortant (443) part vers l'orchestrateur (iota.api.macrocosmos.ai), vers Cloudflare R2 pour les poids du modèle, et vers Hugging Face pour les ressources de tokenizer/modèle. Rien de tout cela n'exige de redirection de port entrant.
• Le transfert pair-à-pair utilise iroh↗, un transport basé sur QUIC, sur un port UDP éphémère qui change d'une exécution à l'autre — il n'y a pas de port P2P fixe ou configurable à rediriger. Iroh est conçu pour fonctionner derrière un NAT sans redirection de port ni UPnP, grâce au hole-punching avec un relais de secours.

Pour vérifier votre propre configuration, trois contrôles sûrs et en lecture seule :

1. lsof -nP -i — voir ce que l'application et son processus de calcul écoutent et à quoi ils sont réellement connectés.
2. Chercher No routable peers dans le journal CLI (~/Library/Logs/IOTA Train at Home/<date>-cli.log) — cette ligne signifie que l'application n'a pas trouvé de pair P2P pour un transfert donné à ce moment-là.
3. Chercher Registered with P2P node ID dans le même journal — sa présence (ou son absence répétée) dans le temps indique si cette exécution a établi une identité P2P.

Par précaution générale, envisagez d'éviter les VPN pendant l'entraînement : un VPN s'intercale entre votre Mac et le chemin réseau dont Train at Home dépend, et le saut supplémentaire ainsi que la translation NAT/le tunneling qu'il ajoute sont une source fréquente du même type de latence et de bruit de connexion dont il est question dans cette section.

Pour le tableau complet — y compris comment lire l'entrée que l'orchestrateur détient pour votre propre machine — consultez le guide réseau et ports.

Débit : ne vous fiez pas à un seul chiffre

Train at Home lance un test de débit intégré plusieurs fois par jour et en remonte le résultat. Il n'existe pas de seuil local publié de réussite/échec — passer une journée entière de journaux CLI au crible à la recherche d'un minimum de débit ne donne rien, ce qui suggère qu'il s'agit de télémétrie plutôt que d'un filtre local.

Ce que nous avons pu vérifier, sur un Mac et une ligne fibre gigabit, en un après-midi de tests : le test de débit intégré choisit automatiquement un serveur sans aucun contrôle de l'utilisateur, et le résultat dépend surtout du serveur tiré, pas de la ligne réelle :

Source	Descendant	Montant
networkQuality de macOS (multi-flux)	~995 Mbps	~715 Mbps
Test intégré, serveur proche	266–371 Mbps	289–301 Mbps
Test intégré, serveur distant	13,8–15,5 Mbps	28,7–30,0 Mbps

Même Mac, même ligne, même après-midi — un résultat de « 15 Mbps » et un résultat de « 370 Mbps », uniquement parce que le serveur de test tiré n'était pas le même. Si le speed test de votre Train at Home semble anormalement bas, c'est la première chose à écarter avant de soupçonner votre connexion : lancez networkQuality dans le Terminal et comparez. Le guide sur le speed test détaille cette démarche, avec les autres causes à écarter (un VPN, une liaison montante chargée, Wi-Fi contre Ethernet).

Suivi : voir ce que l'application officielle ne montre pas

L'interface de l'application officielle Train at Home n'affiche pas votre vraie position dans la file — un manque connu, pas un bug d'affichage — donc si vous voulez savoir où vous en êtes réellement, vous avez deux options :

1. Le lire vous-même. La position dans la file, la phase et le statut d'inscription sont tous écrits en clair dans le journal CLI. Ce guide montre exactement quoi y chercher.
2. Laisser un outil s'en charger. subnera est une petite application, en lecture seule, qui vit dans la barre des menus, lit ce même journal et affiche directement la position dans la file, la phase et le débit — voir comment l'installer. Si vous faites tourner plusieurs Mac, subnera hub ajoute un tableau de bord unique pour toute la flotte — voir le guide multi-Mac.

Ni l'un ni l'autre ne communique avec le port de contrôle local de l'application officielle, et aucun des deux n'est nécessaire pour utiliser Train at Home — ils ne font que rendre le journal existant plus facile à lire.

La checklist en 10 points

1. Vérifiez que l'application officielle affiche « Connected » après l'installation (guide d'installation).
2. Branchez le Mac sur secteur — ne comptez pas sur la batterie pour une nuit entière.
3. Lancez une revendication de veille (caffeinate -dims, ou l'équivalent dans Réglages Système) — voir le guide sur la veille.
4. Vérifiez qu'elle est bien active avec pmset -g assertions.
5. Utilisez une connexion réseau stable ; évitez les VPN pendant l'entraînement.
6. Ne touchez pas à 127.0.0.1:8010 — ce n'est pas un port à configurer.
7. En cas d'avertissements répétés « No routable peers », lisez le guide réseau avant de penser que quelque chose est cassé.
8. Si un résultat de speed test semble anormalement bas, comparez-le à networkQuality avant de blâmer votre ligne (guide speed test).
9. Installez subnera pour voir votre vraie position et votre vraie phase sans fouiller dans les journaux (guide d'installation).
10. Si quelque chose semble encore bloqué, consultez le guide de dépannage avant de redémarrer l'application — un redémarrage vous replace en fin de file.

Guides liés

• Qu'est-ce qu'IOTA Train at Home ?
• Installer et configurer Train at Home sur macOS
• Empêcher la veille du Mac avec caffeinate
• Réseau, ports et P2P
• Lire sa position dans la file depuis le journal
• Installer subnera
• Faire tourner Train at Home sur plusieurs Mac
• Dépannage de Train at Home
• Récompenses et versements
• Pourquoi votre speed test semble faible