Recalbox embarque un serveur SSH : depuis n'importe quel ordinateur du réseau, vous ouvrez un terminal avec les droits root sur votre Recalbox. C'est la porte d'entrée de la plupart des manipulations avancées du wiki.
N'exposez jamais votre Recalbox sur Internet, en particulier le port 22. Le mot de passe root par défaut est public : une Recalbox joignable depuis l'extérieur sera compromise.
| Hôte | recalbox (Windows), recalbox.local (macOS, Linux, Android, iOS), ou l'adresse IP |
| Port | 22 |
| Utilisateur | root (toujours) |
| Mot de passe | recalboxroot par défaut |
Pour connaître l'adresse IP de votre Recalbox : START → OPTIONS RÉSEAU, ligne ADRESSE IP.
Si vous avez défini un mot de passe au moment du flash avec Raspberry Pi Imager (Recalbox 10.0 et supérieur), c'est celui-là qu'il faut utiliser, pas
recalboxroot. De même si vous avez changé leNOM SUR LE RÉSEAUde la machine : utilisez ce nom à la place derecalbox.
Ouvrez PowerShell (ou le Terminal Windows) et tapez :
ssh root@recalbox
Vous pouvez aussi utiliser un client graphique : PuTTY ou MobaXterm.
Ouvrez le Terminal (Applications → Utilitaires) :
ssh root@recalbox.local
Ouvrez un terminal :
ssh root@recalbox.local
À la première connexion, votre client vous demande d'accepter l'empreinte du serveur : répondez yes.
Vous cherchez plutôt à copier des fichiers ? Voyez Accéder à Recalbox depuis son ordinateur (SFTP/SSH).
Avec un clavier branché sur la Recalbox :
ALT + F2 ouvre un terminal en arrière-plan (il n'est pas visible immédiatement) ;ALT + F4 quitte l'interface et affiche le terminal.Les identifiants sont les mêmes que ci-dessus.
La bonne méthode, celle qui survit aux mises à jour, passe par recalbox.conf :
Sur votre ordinateur, générez l'empreinte de votre mot de passe :
openssl passwd -1 votre_mot_de_passe
Dans recalbox.conf, renseignez le résultat :
system.default_password=$1$xxxxxxxx$yyyyyyyyyyyyyyyyyyyyy
Redémarrez : le nouveau mot de passe s'applique au SSH et au partage réseau Samba.
La commande
passwdfonctionne aussi, mais la modification est perdue à la prochaine mise à jour de Recalbox : le mot de passe est régénéré à chaque démarrage à partir derecalbox.conf.
Déposez votre clé publique dans le fichier /recalbox/share/system/.ssh/authorized_keys — accessible depuis le partage réseau, dossier system. Une clé par ligne, comme sur n'importe quel serveur Linux.
Si vous n'utilisez jamais le SSH, coupez-le dans recalbox.conf :
system.ssh.enabled=0