Garder sa sandbox en VPS
Une sandbox d'essai est supprimée 24 h après sa création. Pour conserver votre travail, transformez-la en VPS YorkHost classique : une machine à vous, avec une adresse IP publique, gérée dans votre espace client comme n'importe quel VPS.
Ce que vous obtenez
- Un VPS-2 : 2 vCores, 2 Go de RAM, 80 Go de SSD, une adresse IP publique. Au moment où cette page est écrite, il coûte 3,99 €/mois ; le prix exact vous est toujours affiché avant que la commande soit passée.
- Le VPS est installé avec la même image que la sandbox (Ubuntu 24.04 avec les agents IA préinstallés).
- Le dossier
/home/agentde la sandbox y est copié et vérifié (hors dossier de cache~/.cache), puis la sandbox est supprimée. - Vous vous connectez directement au VPS avec la même clé SSH :
ssh agent@<IP du VPS>.
Les paquets installés avec apt, les images et conteneurs Docker, et tout fichier placé hors de /home/agent ne sont pas repris. Gardez votre code, vos fichiers docker-compose.yml et vos scripts d'installation dans /home/agent pour tout reconstruire en quelques commandes.
Seules les sandboxes Linux peuvent devenir un VPS.
Étape 1 : récupérer le lien de réclamation
Il est affiché à la création de la sandbox (ligne Keep it as a VPS) et a cette forme :
https://api.yorkhost.fr/sandbox/claim#yhsc_…
Perdu ? Reconnectez-vous avec la même clé SSH :
ssh claim@yorkhost.sh
La réponse JSON contient un nouveau claim_url et le claim_token (yhsc_…) correspondant. L'ancien lien ne fonctionne plus.
La réclamation est possible tant que la sandbox tourne ou qu'elle est arrêtée, jusqu'à sa suppression (24 h après la création).
Étape 2 : un compte YorkHost relié à votre agent
La commande passe par votre compte YorkHost, là où le prix vous est montré et où vous le validez :
- Créez un compte sur clients.yorkhost.fr si vous n'en avez pas.
- Activez la double authentification (obligatoire pour l'API et le MCP).
- Reliez YorkHost à votre assistant IA avec le serveur MCP (Claude, ChatGPT, Cursor…), ou créez une clé API avec la permission « Commander des services » (
orders:write).
Étape 3 : réclamer et valider le prix
Demandez simplement à votre assistant : « Réclame ma sandbox YorkHost », en collant le lien ou le jeton yhsc_…. Il utilise l'outil claim_sandbox, en deux temps :
- Préflight : rien n'est commandé. L'assistant vous montre le produit, le prix et le cycle de facturation (mensuel, renouvellement automatique).
- Confirmation : seulement après votre accord explicite, il confirme. La commande et la facture sont créées, et il vous donne le lien de paiement.
Sans assistant, le même parcours se fait avec POST /client/v1/sandboxes/claim (voir API et MCP).
Étape 4 : payer la facture
Le paiement se fait sur la page sécurisée de YorkHost (carte bancaire avec 3-D Secure, PayPal, crédit du compte), jamais dans la conversation avec l'agent. Si le crédit de votre compte couvre la facture, elle est réglée automatiquement.
Vous avez 72 heures après la commande pour payer. Sans paiement dans ce délai, la sandbox et ses fichiers sont supprimés.
Une fois la commande passée, la sandbox n'est plus accessible en SSH (waiting for its VPS invoice to be paid, puis is being moved to your new VPS). Ses fichiers restent intacts jusqu'à la copie.
Étape 5 : le VPS est prêt
Dès la facture payée :
- Le VPS est créé, comme toute commande de VPS, et apparaît dans votre espace client avec son adresse IP.
- Le dossier
/home/agentest copié de la sandbox vers le VPS, puis vérifié (même nombre de fichiers, même taille totale). En cas d'échec, la copie est retentée ; la sandbox n'est supprimée qu'après une copie vérifiée. - La sandbox d'essai est supprimée.
Connectez-vous ensuite directement, sans passer par yorkhost.sh :
ssh agent@<IP du VPS>
Votre agent peut suivre l'avancement avec list_sandboxes (champs status, transfer_state, vps_ip).
Et après ?
Votre VPS est désormais un service YorkHost ordinaire, sans les limites de la sandbox (tous les ports, adresse IP publique, pas de durée limite tant qu'il est payé). Pensez à le sécuriser :
- Sécuriser SSH et configurer un pare-feu UFW
- Mettre en place un reverse proxy pour publier votre application sur votre nom de domaine
- Renouvellement automatique et résiliation