Commandes SSH

Tout se pilote par SSH : le nom d'utilisateur placé devant @yorkhost.sh choisit l'action.

Commande	Effet
ssh yorkhost.sh	Ouvre votre sandbox Linux, ou en crée une si votre clé n'en a pas.
ssh <id>@yorkhost.sh	Rejoint une sandbox précise (sbx…), avec la clé qui l'a créée.
ssh yorkhost.sh 'commande'	Exécute la commande dans la sandbox et rend son code de sortie.
ssh status@yorkhost.sh	Liste vos sandboxes en JSON (état, URLs, échéances).
ssh claim@yorkhost.sh	Génère un nouveau lien pour garder la sandbox en VPS (JSON).
ssh destroy@yorkhost.sh	Supprime vos sandboxes et leurs fichiers (JSON).

Se reconnecter

Deux façons, avec la même clé SSH :

ssh yorkhost.sh                  # votre sandbox Linux en cours
ssh sbxabcd2345efgh@yorkhost.sh  # une sandbox précise

Chaque reconnexion rappelle l'heure d'arrêt :

↩  sandbox sbxabcd2345efgh — runs until 14:32 UTC · new links: ssh claim@yorkhost.sh

Fermer la connexion ne met pas la sandbox en pause : elle continue de tourner jusqu'à son heure d'arrêt. En revanche, les programmes lancés au premier plan s'arrêtent avec votre session. Pour les garder actifs après une déconnexion, utilisez tmux (préinstallé) :

tmux new -s travail      # ouvre une session persistante
# Ctrl+B puis D pour s'en détacher
tmux attach -t travail   # s'y rattacher après reconnexion

Lancer une commande à distance

Comme avec n'importe quel serveur SSH, une commande passée après l'hôte s'exécute dans la sandbox. C'est la façon la plus simple pour un agent ou un script local d'utiliser la sandbox :

ssh yorkhost.sh 'cd projet && npm test'

Le code de sortie de la commande est renvoyé tel quel : un script voit donc l'échec d'un test. Les messages de YorkHost (création, rappel d'échéance) partent sur la sortie d'erreur et ne polluent pas la sortie standard.

Pour un script ou un agent

Ajoutez -o StrictHostKeyChecking=accept-new pour que la première connexion n'attende pas de confirmation interactive de l'empreinte de yorkhost.sh.

status : où en sont mes sandboxes ?

ssh status@yorkhost.sh

{
  "sandboxes": [
    {
      "id": "sbxabcd2345efgh",
      "kind": "linux",
      "status": "running",
      "ssh": "ssh sbxabcd2345efgh@yorkhost.sh",
      "preview_url": "https://sbxabcd2345efgh-8080.yorkhost.sh",
      "created_at": "2026-09-27T13:32:00Z",
      "run_until": "2026-09-27T14:32:00Z",
      "claim_until": "2026-09-28T13:32:00Z"
    }
  ]
}

Champ status	Signification
provisioning	Création en cours.
running	La sandbox fonctionne, jusqu'à run_until.
stopped	La période gratuite est finie : VM éteinte, fichiers conservés jusqu'à claim_until.
claim_pending	Un VPS a été commandé pour la garder, la facture attend son paiement.
transferring	Facture payée : création du VPS et copie de /home/agent.

Les dates sont en UTC (format ISO 8601). La commande ne crée jamais de sandbox.

claim : obtenir un nouveau lien pour garder la sandbox

ssh claim@yorkhost.sh

Renvoie, pour chaque sandbox en cours ou arrêtée de votre clé, un nouveau claim_url (et le claim_token qu'il contient). Utile si vous avez perdu le lien affiché à la création.

warning

Chaque appel remplace le lien précédent : l'ancien lien cesse de fonctionner. La suite de la démarche est décrite dans Garder sa sandbox en VPS.

destroy : tout supprimer

ssh destroy@yorkhost.sh

Supprime immédiatement et définitivement les sandboxes de votre clé (en cours, arrêtées ou en création) avec tous leurs fichiers. La réponse JSON liste les sandboxes supprimées. Une sandbox déjà en cours de passage en VPS n'est pas concernée.

C'est aussi la commande à utiliser pour repartir de zéro : une clé ne peut avoir qu'une sandbox à la fois.

Tunnels vers un port de la sandbox (ssh -L)

Pour accéder depuis votre machine à un service qui n'écoute qu'en local dans la sandbox (base de données, serveur de dev sur un autre port que ceux des previews…) :

ssh -L 5432:localhost:5432 yorkhost.sh

Vous joignez alors localhost:5432 sur votre ordinateur. Seuls les ports de la sandbox elle-même (localhost) peuvent être relayés : les tunnels vers d'autres machines, les tunnels inverses (ssh -R) et le transfert d'agent SSH (ssh -A) ne sont pas pris en charge.

Transférer des fichiers (scp, sftp, rsync)

Les fichiers arrivent dans /home/agent. Précisez l'identifiant de la sandbox pour être sûr de viser la bonne :

# Envoyer un dossier
scp -r ./mon-projet sbxabcd2345efgh@yorkhost.sh:

# Récupérer un fichier
scp sbxabcd2345efgh@yorkhost.sh:mon-projet/dist.zip .

# Synchroniser
rsync -av ./mon-projet/ sbxabcd2345efgh@yorkhost.sh:mon-projet/

# Session interactive
sftp sbxabcd2345efgh@yorkhost.sh

Les clients graphiques (FileZilla, WinSCP…) fonctionnent aussi en SFTP : hôte yorkhost.sh, port 22, utilisateur = identifiant de la sandbox, authentification par votre clé.

Récupérez vos fichiers avant l'arrêt

Une sandbox arrêtée n'est plus joignable. Si vous ne comptez pas la garder en VPS, copiez ce qui vous intéresse avant l'heure d'arrêt, ou poussez votre travail sur un dépôt Git.