Connecter un Mac sous Train at Home au hub subnera, pas à pas

Ce guide détaille la procédure qui relie un Mac à subnera hub : créer un compte, obtenir un jeton à usage unique et le coller dans l'app de la barre des menus. Pour ce que le hub offre ensuite, voyez la présentation du hub de flotte. subnera est non officiel et sans lien avec IOTA, Macrocosmos ou Bittensor.

subnera doit déjà tourner sur le Mac. S'il n'est pas encore installé, commencez par le guide d'installation.

1. Créer un compte

1. Ouvrez app.subnera.com↗ et choisissez Créer un compte.
2. Saisissez une adresse e-mail, un mot de passe et sa confirmation, puis validez.
3. Facultatif : plus tard, sur la page du compte, utilisez Ajouter une clé d'accès pour vous connecter avec votre empreinte, votre visage ou le code de votre appareil. Votre mot de passe reste utilisable.

L'inscription est ouverte par défaut, mais un opérateur peut la fermer sur un hub donné. La page indique alors « Les inscriptions sont fermées sur ce hub. »

2. Choisir ou créer un pool

Un pool est un groupe de Mac affichés ensemble sur un tableau de bord. La création du compte crée un pool nommé Personal : vous pouvez passer cette étape. Pour en créer un autre, allez sur Nouveau pool, saisissez un Nom du pool et appuyez sur Créer le pool. Les rôles et le partage sont traités dans le guide sur les pools et les rôles.

3. Générer le jeton d'installation

1. Ouvrez la page du pool. Le tableau de bord s'ouvre sur votre pool préféré.
2. Appuyez sur + Ajouter une machine. Un panneau affiche l'URL du hub et un jeton commençant par tok_.
3. Copiez les deux.

Le jeton est valable une heure (le panneau indique son heure d'expiration) et ne sert qu'une fois. Ne le publiez pas : il permet d'ajouter un Mac à ce pool. Le bouton n'apparaît que si votre rôle dans le pool permet de gérer les machines (admin ou propriétaire). Si vous perdez le jeton, générez-en un autre.

4. Le coller dans l'app de la barre des menus

1. Sur le Mac, cliquez sur l'icône subnera de la barre des menus et choisissez Remote Dashboard Settings….
2. Dans Hub URL, saisissez l'adresse affichée dans le panneau. Elle doit commencer par https:// (le http:// n'est accepté que pour localhost).
3. Dans Install token, collez le jeton.
4. Appuyez sur Connect.

La ligne d'état passe à « Connected as m_… » et le Mac apparaît dans la grille de flotte, normalement en quelques secondes. Les champs sont ensuite verrouillés jusqu'à un clic sur Disconnect.

Ce que le Mac conserve et envoie

L'enrôlement donne au Mac une clé privée, que subnera garde dans le trousseau macOS de cet appareil uniquement. L'URL du hub et l'identifiant de la machine sont conservés dans les préférences de l'app. Sans enrôlement, l'app n'envoie rien au hub.

Une fois connectée, l'app envoie un rapport environ toutes les 10 secondes, en HTTPS. Un rapport contient :

• les informations sur l'hôte : nom de la machine, modèle de Mac, version de macOS et durée de fonctionnement ;
• les versions de subnera et de l'application officielle, et la clé publique (hotkey) ;
• l'état de l'application officielle (en cours ou non, présence de processus orphelins, surveillant activé ou non) ;
• l'état déjà suivi par l'app : phase, position dans la file, couche, tokens et passes par heure, tests de vitesse, mises à jour.

Des lignes de journal ne sont envoyées que lorsque vous demandez une diffusion en direct depuis le hub. Les clés privées de portefeuille ne sont jamais lues ni envoyées. Une machine est considérée en ligne tant que son dernier rapport date de moins de 90 secondes.

Facultatif : Allow remote control

Dans la même fenêtre, Allow remote control (start / stop / restart / watchdog) est désactivé après chaque enrôlement, et ne peut être coché qu'une fois le Mac connecté. Tant qu'il ne l'est pas, le Mac ignore les commandes du hub. Décochez-le à tout moment, sans reconnexion. Voir le guide sur le consentement.

Gérer une machine depuis le hub

Ouvrez la machine depuis la grille ; en bas de sa page :

• Renommer : modifiez Nom de la machine (60 caractères maximum) et appuyez sur Renommer. Cela demande le rôle admin ou propriétaire.
• Déplacer vers le pool : choisissez un pool et appuyez sur Déplacer. Il faut gérer les machines des deux pools. Un Mac prêté peut repartir avec Retour au prêteur.
• Révoquer : après confirmation, le Mac cesse immédiatement d'envoyer des rapports et sa clé est invalidée.

Déconnecter ou révoquer

Depuis le Mac, dans Remote Dashboard Settings…, appuyez sur Disconnect. La clé quitte le trousseau, la machine est oubliée et le contrôle à distance est désactivé, sans le hub. La machine reste listée sur le hub, hors ligne, tant que quelqu'un ne la révoque pas.

Depuis le hub, appuyez sur Révoquer. Le menu du Mac affiche alors « Remote: revoked — reconnect in Remote Dashboard Settings… ». Pour la reconnecter, générez un nouveau jeton.

Échecs d'enrôlement courants

Message sur le Mac	Cause et solution
Enter an https:// URL.	L'URL du hub est vide ou n'est pas en HTTPS. Copiez-la depuis le panneau du hub.
Paste the install token.	Le champ du jeton est vide.
Token invalid, already used or expired.	Un jeton dure une heure et ne sert qu'une fois. Générez-en un nouveau.
Too many attempts — wait a minute and try again.	Le hub limite les tentatives d'enrôlement. Patientez, puis réessayez.
Could not store the key in the Keychain.	macOS a refusé l'écriture. Déverrouillez le trousseau de session, autorisez l'accès et appuyez de nouveau sur Connect.
This hub requires a newer version of subnera. Please update.	Le hub parle un protocole plus récent que votre app. Mettez l'app à jour.
Failed: Hub returned an unexpected error (HTTP 409).	Le hub répond 409 quand le compte a atteint sa limite de machines. Révoquez un Mac inutilisé, puis réessayez avec le même jeton s'il n'a pas expiré.
Failed: suivi d'une erreur réseau	Vérifiez la connexion du Mac et l'URL du hub. L'app ne suit pas les redirections : utilisez l'adresse exacte affichée par le hub.

Si le Mac se connecte mais que le menu affiche « Keychain access denied », relancez l'app et autorisez l'accès, ou appuyez sur Disconnect et enrôlez-le de nouveau avec un nouveau jeton. Pour un Mac connecté qui semble bloqué, voyez les états d'inscription et le dépannage.