Nouveau · l'app mobile, second appareil pour relire et signer chaque ordre
kantamaSe connecterCréer un espace

CLI kantama

Le binaire kantama n'a qu'une famille de commandes : kantama agent …, l'agent installé sur chaque serveur.

2 minutesMis à jour le 18 novembre 2026

Installer le binaire

Terminal · le serveur
curl -fsSL https://kantama.app/installer.sh | sh
kantama agent version

Téléchargement manuel et vérification de l'empreinte (Linux, Windows) : voir Démarrer, étape 2.

Commandes

CommandeOptionsEffet
init[--dossier D]crée l'identité de l'agent (jamais écrasée)
empreinte[--dossier D]affiche l'empreinte à comparer lors de l'enrôlement
enroler--central URL --code CODE [--dossier D] [--manifeste kantama.yaml]
--central URL --reprendre agt_… [--dossier D]
rattache ce serveur à votre espace (code à usage unique) ; --reprendre reprend, avec la même identité et sans nouveau code, un enrôlement interrompu
connecter--central URL --manifeste FICHIER [--dossier D] …connexion sortante : reçoit les ordres, renvoie des reçus signés
appliquerFICHIER --manifeste kantama.yaml [--dossier D] [--recu CHEMIN]serveur coupé du central : vérifie et exécute un ordre signé en différé, remis par fichier, et écrit son reçu signé (mode hors ligne)
confiance[--dossier D]liste les passkeys de confiance
politique[--dossier D]affiche la politique de l'agent (gels, plages horaires, règles)
manifesteFICHIERvalide un kantama.yaml et affiche la liste fermée, puis chaque procédure et son empreinte
versionaffiche la version du binaire

Sans argument, ou avec une commande inconnue, kantama affiche cette aide et sort avec le code 2. Une erreur sort avec le code 1.

enroler

Crée l'identité si besoin, affiche l'empreinte groupée par 4, puis attend votre approbation dans la console. Avec --manifeste, l'agent joint un résumé de kantama.yaml aux vérifications affichées dans la console (horloge, binaire, Docker, conteneurs).

Terminal · le serveur
kantama agent enroler --central https://kantama.app --code K7Q-4M2-XP9 --manifeste kantama.yaml

connecter et ses options

Refuse de démarrer sans passkey de confiance (« l'agent refuserait tout ordre »), ou si --central n'est pas le central de l'enrôlement.

OptionDéfautRôle
--dossier/var/lib/kantama-agent (Linux)dossier d'état de l'agent
--port-http, --port-https80, 443ports publiés par kantama-proxy (0 : pas de HTTPS)
--sondes30sintervalle des sondes de santé, 0 pour aucune
--certificatspublicpublic (domaine:443) ou local (kamal-proxy de ce serveur)
--certificats-intervalle6hintervalle de relevé des certificats
--sauvegardes30svérification du planning des sauvegardes, 0 pour sur ordre seulement
--mesures30srelevé des conteneurs du projet, 0 pour aucun
--dns10mrésolution des enregistrements DNS attendus, 0 pour « Actualiser » seulement
--securite10mrelevé de la sécurité de l'hôte (mises à jour, redémarrage requis, SSH, pare-feu), 0 pour aucun
--hote-racine/racine de l'hôte pour lire processeur, mémoire et disques du serveur ; /host pour un agent en conteneur
--connecteurs5mlecture des plateformes, 0 pour sur demande seulement
--surveillance1mretrait des prévisualisations échues
--derive10mcomparaison de l'état réel à l'état signé (Dérive), 0 pour aucune
--derive-confirmation30sdélai avant de confirmer un écart nouveau (un état passager n'est pas signalé)
--proxy-nom, --reseaukantama-proxy, kantamaconteneur kamal-proxy et réseau Docker
Terminal · le serveur
kantama agent connecter --central https://kantama.app --manifeste kantama.yaml --sondes 30s --certificats public

Contrôler sans rien changer

Terminal · le serveur
kantama agent empreinte    # à comparer avec la console
kantama agent confiance    # passkeys acceptées par cet agent
kantama agent manifeste kantama.yaml
Cette page vous a-t-elle aidé ?Modifier cette page

Les propositions de modification de la documentation ne sont pas encore ouvertes au public.