Documentation / Démarrer

Se connecter et activer une machine

Mis à jour le

TL;DR — `tokenade login` ouvre tokenade.net, vous approuvez l'appareil, et une licence signée est mise en cache dans `~/.tokenade/license.key`. Sur un serveur : `--no-browser`.

Pour activer Tokenade sur une machine, lancez tokenade login et approuvez la demande dans votre navigateur. Tokenade a besoin d'un compte actif sur chaque machine où il tourne : tant que la machine n'est pas activée, il ne compacte rien.

tokenade login

Pas encore de compte ? Créez-en un sur tokenade.net/signup. L'offre gratuite ne demande pas de carte ; les limites de chaque offre sont sur la page des tarifs.

Le déroulé de la connexion

tokenade login demande un code à usage unique à tokenade.net, affiche l'URL d'approbation et le code, puis ouvre l'URL dans votre navigateur par défaut :

To activate Tokenade, authorize this machine in your browser:

https://tokenade.net/activate?code=ABCD-EF23

(verification code: ABCD-EF23)

Waiting for you to authorize… (Ctrl-C to cancel)

Connectez-vous sur cette page si besoin, vérifiez que le code est le même, et approuvez dans les 10 minutes (la durée de vie du code). Le terminal interroge le serveur toutes les 3 secondes et termine tout seul :

✓ This machine is now activated.
plan: free · quota: … tokens saved (this month)
manage machines / upgrade at https://tokenade.net/dashboard

Si aucun agent de code n'est encore branché, la connexion lance alors tokenade install pour vous (« Wiring up your coding agents so the savings actually kick in »). Si des agents sont déjà configurés, elle le dit et ne change rien.

Sur un serveur ou en SSH

L'option --no-browser évite d'ouvrir un navigateur. Tokenade affiche l'URL ; ouvrez-la sur n'importe quel appareil (votre portable, votre téléphone), approuvez, et le serveur récupère l'approbation.

tokenade login --no-browser
OptionEffet
--no-browserN'ouvre pas de navigateur, affiche seulement l'URL
--help, -hAffiche l'aide

Quand la connexion échoue

MessageQue faire
✗ Authorization was declined in the browser.Relancez tokenade login et approuvez
✗ This request expired. Run tokenade login again.Le code expire au bout de 10 minutes ; recommencez
✗ Timed out waiting for authorization.Idem : relancez tokenade login
✗ Machine limit reached: …Le plafond de machines de votre offre est atteint (sièges Enterprise) ; libérez une place sur tokenade.net/dashboard ou ajoutez des sièges

Le fichier de licence

Une connexion réussie met en cache une licence signée, liée à la machine, dans ~/.tokenade/license.key (%USERPROFILE%\.tokenade\license.key sous Windows). Elle est signée par tokenade.net et vérifiée localement : Tokenade n'a donc pas besoin du réseau à chaque appel.

  • La licence en cache vaut environ 30 jours et se renouvelle automatiquement via l'envoi des statistiques d'usage en arrière-plan. Vous n'avez jamais à relancer login pour cela.
  • tokenade healthcheck en montre l'état sur sa ligne license active, avec votre offre et l'usage du mois.

Rester connecté

Tokenade envoie des compteurs d'usage anonymes à tokenade.net (voir Ce que Tokenade envoie et conserve). Une courte coupure ne pose pas de problème : vous pouvez travailler hors ligne. Si les envois échouent pendant plus de 72 heures, Tokenade se met en pause, comme lorsqu'un quota est épuisé. Il reprend tout seul à la première synchronisation réussie, dès que tokenade.net est de nouveau joignable.

Machines

  • Free et Pro : machines illimitées.
  • Enterprise : au siège, 3 machines par siège.

Lancez tokenade login une fois sur chaque machine. Vous les voyez et les gérez toutes sur tokenade.net/dashboard.

Délier une machine

Il n'existe pas de commande logout. Pour délier une machine, deux possibilités :

  • La retirer depuis le tableau de bord. À son envoi suivant, le serveur répond 403 avec MACHINE_REVOKED, Tokenade supprime la licence et le quota en cache, et cesse de compacter jusqu'à un nouveau tokenade login.
  • Désinstaller Tokenade sur cette machine. tokenade uninstall supprime ~/.tokenade/, y compris license.key. Pour libérer aussi la machine dans votre compte, supprimez-la sur tokenade.net/dashboard. Voir Mettre à jour et désinstaller.

Codes de parrainage

Si l'on vous a donné un code de parrainage, passez-le à l'installation :

tokenade install --ref <code>

Voir aussi