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 ou une clé de votre compte.
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 -T export@yorkhost.sh > sandbox.tar.gz	Télécharge /home/agent en archive .tar.gz.
ssh destroy@yorkhost.sh	Supprime vos sandboxes et leurs fichiers (JSON).

Se reconnecter

Deux façons, avec la même clé SSH (ou, pour une sandbox créée depuis votre compte, n'importe quelle clé enregistrée sur le compte avec son identifiant) :

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.

attention

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.

export : télécharger vos fichiers

Pour ne rien perdre sans garder la sandbox, téléchargez tout le dossier /home/agent en une archive :

ssh -T export@yorkhost.sh > sandbox.tar.gz                   # votre sandbox
ssh export@yorkhost.sh sbxabcd2345efgh > sandbox.tar.gz      # une sandbox précise

• L'archive contient /home/agent (sans le cache ~/.cache), comme la copie vers un VPS. Décompressez-la avec tar xzf sandbox.tar.gz.
• La sandbox doit être en cours : une sandbox arrêtée ne redémarre pas, il reste seulement à la garder en VPS. Pensez à exporter avant l'heure d'arrêt.
• Le -T est nécessaire depuis un terminal : sans lui, SSH ouvre une session interactive et l'archive n'est pas envoyée (une aide s'affiche à la place). Il est inutile quand vous indiquez l'identifiant ou depuis un script.
• Si vous avez plusieurs sandboxes, la commande liste les identifiants à indiquer. Elle ne crée jamais de sandbox.
• Le code de sortie est celui de tar : 1 signale qu'un fichier a changé pendant la lecture, l'archive reste utilisable.

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 (export récupère tout /home/agent d'un coup), ou poussez votre travail sur un dépôt Git.