FAQ

Démarrer, activer SSH, joindre votre machine, et ce qui coince.

Les commandes ci-dessous se lancent sur votre machine, dans son propre terminal. Aucune n’est nécessaire à Nekoia lui-même : ce sont les moyens habituels de rendre une machine joignable en SSH.

Démarrer

Appairer votre appareil

Dans Nekoia, touchez + (Ajouter une machine).
Remplissez Hôte, Utilisateur et Mot de passe : l’adresse de votre machine, votre compte sur elle et son mot de passe. Touchez Se connecter.
Sous Vérifier l’empreinte, comparez l’empreinte à celle de votre machine (où la lire), puis touchez de nouveau Se connecter.

Le mot de passe sert une fois, à ajouter la clé de votre appareil à votre machine ; Nekoia ne le garde pas. Cette clé naît dans la Secure Enclave de votre appareil et s’utilise sous Face ID.

Appeler votre agent

Sous votre machine, touchez Ajouter un agent, choisissez Claude Code ou Codex, puis son dossier.
Touchez la ligne de l’agent : elle ouvre son terminal et lance l’agent.
Touchez le téléphone en verre, en haut à droite du terminal (un double tap fait revenir les boutons s’ils sont masqués) : la barre d’appel apparaît, et vous parlez.

Votre voix est un clavier et n’accorde jamais rien. Une autorisation, une question ou un plan à valider se règle à l’écran, dans le terminal.

Activer SSH

Sur un Mac

Réglages Système > Général > Partage > Session à distance. Le bouton ⓘ à côté montre qui peut se connecter : choisissez Tous les utilisateurs, ou ajoutez votre compte sous Uniquement ces utilisateurs. Cette liste est le groupe com.apple.access_ssh ; pour y ajouter votre compte depuis un terminal :

sudo dseditgroup -o edit -a "$USER" -t user com.apple.access_ssh

Mon projet est dans Bureau, Documents ou Téléchargements

macOS protège ces dossiers. Dans le même panneau Session à distance, activez l’accès complet au disque pour les utilisateurs distants, ou gardez vos projets dans un autre dossier.

Sur Linux

Debian et Ubuntu :

sudo apt install openssh-server
sudo systemctl enable --now ssh

Fedora :

sudo dnf install openssh-server
sudo systemctl enable --now sshd

L’appairage est refusé alors que le mot de passe est juste

Le premier appairage se connecte avec votre mot de passe : OpenSSH doit l’accepter (PasswordAuthentication yes dans /etc/ssh/sshd_config ou dans un fichier de /etc/ssh/sshd_config.d/). Une fois votre appareil appairé, il se connecte avec sa clé, et vous pouvez de nouveau refuser les mots de passe.

La clé de votre appareil est de type ecdsa-sha2-nistp256. Si votre configuration restreint PubkeyAcceptedAlgorithms, gardez ce type dans la liste. Votre machine doit aussi proposer une clé d’hôte Ed25519 ou ECDSA, qu’OpenSSH crée par défaut : une machine qui n’a qu’une clé d’hôte RSA est refusée.

Où lire l’empreinte de ma machine ?

Sur la machine :

for key in /etc/ssh/ssh_host_*_key.pub; do ssh-keygen -lf "$key"; done

L’une de ces lignes doit montrer l’empreinte que Nekoia affiche sous Vérifier l’empreinte. Si aucune ne la montre, ne vous connectez pas.

Joindre votre machine

Ça marche chez moi, pas en données cellulaires

Une adresse comme 192.168.1.20 ou 10.0.0.5 est privée : elle n’existe que sur votre réseau. Hors de celui-ci, deux possibilités, dont aucune n’est exigée par Nekoia :

Un réseau privé qui relie votre machine et votre appareil, où qu’ils soient. Mettez alors dans Hôte le nom ou l’adresse que ce réseau donne à la machine.
Une machine Linux louée chez un hébergeur (un VPS), qui ne dort jamais, avec votre agent installé dessus.

Nous déconseillons d’ouvrir le port 22 de votre box sur internet.

Mon Mac se met en veille

Désactivez la suspension automatique sur secteur : Réglages Système > Batterie > Options sur un portable, Réglages Système > Énergie sur un ordinateur de bureau. Ou, depuis un terminal, tant qu’il est sur secteur :

sudo pmset -c sleep 0

Ou seulement tant qu’un terminal reste ouvert :

caffeinate -s

Un portable fermé s’endort quand même, sauf s’il est branché à un écran, un clavier et le secteur.

« The machine is unreachable. » (la machine est injoignable)

Vérifiez, dans cet ordre : la Session à distance (ou sshd) est activée, votre appareil est sur le même réseau que la machine, et la machine est éveillée. Sur iPhone ou iPad, autorisez aussi le Réseau local pour Nekoia : Réglages, Confidentialité et sécurité, Réseau local.

Les agents

L’agent me demande de me connecter, ou d’approuver le dossier

Nekoia lance l’agent comme vous le feriez. La première fois, connectez-vous et approuvez votre dossier dans le terminal de l’agent, à l’écran : il ne le demande qu’une fois.

La connexion tombe pendant un appel

Une coupure ferme le terminal, et l’appel avec ; l’agent lancé dans ce terminal s’arrête aussi. Quand la connexion revient, touchez de nouveau la ligne de l’agent pour le relancer.

Votre appareil

Révoquer un appareil

Chaque appareil appairé ajoute une ligne à ~/.ssh/authorized_keys sur votre machine, terminée par nekoia:tty: et le nom de l’appareil ; un appareil appairé avant le nom Nekoia garde une ligne en passe-plat:tty:, reconnue de même. Pour les lister :

grep -E '(nekoia|passe-plat):tty:' ~/.ssh/authorized_keys

Supprimez la ligne d’un appareil avec n’importe quel éditeur de texte, et cet appareil ne peut plus se connecter. Rien d’autre n’a été installé.

Mis à jour le 26 octobre 2026.