---
title: "Quitter Heroku par MCP, sans réécrire votre appli"
url: https://while.sh/fr/guides/migrer-de-heroku/
author: "Aloïs Oddon, cofondateur de Nextmap"
updated: 2026-11-02
---

# Quitter Heroku sans réécrire votre appli, depuis votre agent IA

Votre facture Heroku grimpe ? Branché à while par MCP, votre agent reprend votre appli telle quelle, recopie votre base, et la met en ligne en France.

## Prérequis

- Une appli sur Heroku, en Node.js, Python ou Go.
- L'accès à votre compte Heroku, pour exporter la base.
- Un agent IA qui travaille dans un terminal : Claude Code, Codex, Cursor ou Gemini CLI.

## Étape 1 : Donnez ces instructions à votre agent

Ouvrez votre agent dans le dossier de votre appli, et collez-lui ces instructions :

```text titre="Instructions"
Connecte-toi à while avec mon compte (while.sh/agents), puis mets mon appli en ligne.
```

Sans compte, votre agent met votre appli en ligne à l'essai, en une demande. Pour la garder, ouvrez le lien qu'il vous donne et créez votre compte.

Avec votre compte, votre agent ajoute lui-même le serveur MCP de while. S'il vous le demande, relancez-le. Au premier appel à while, une page s'ouvre dans votre navigateur. Dans Claude Code, si elle ne s'ouvre pas, tapez /mcp, choisissez while, puis Authenticate. Sur cette page, choisissez votre appli, ou « Une nouvelle appli », puis cliquez sur Autoriser.

## Étape 2 : Ouvrez votre appli

Votre agent vous donne l'adresse de votre appli, par exemple `https://mon-appli.while.cloud`, en HTTPS.

## Ce que fait votre agent

Il écrit while.yaml à la racine de votre appli :

```yaml titre="while.yaml"
apiVersion: while/v1
project: mon-appli
services:
  - name: web
    port: 5006
    health:
      path: /
```

L'exemple Node.js de Heroku est passé sur while sans une ligne changée (source 2).

## Recopier votre base Heroku Postgres

> Vous, à votre agent : Recopie notre base Heroku sur while.

Votre agent exporte la base avec `pg_dump`, puis la recharge dans while.

## Reporter vos variables

> Vous, à votre agent : Reporte nos config vars Heroku.

Votre agent reporte vos réglages dans while. Vos clés secrètes, vous les saisissez vous-même : il ne les voit jamais.

## Remplacer le Heroku Scheduler

> Vous, à votre agent : Reprends les tâches du Heroku Scheduler.

Votre agent les déclare en tâches planifiées, à la même heure.

## Passer sur votre propre domaine

> Vous, à votre agent : Mets l'appli sur www.acme.fr.

Votre agent déclare le domaine, vous ajoutez les enregistrements DNS qu'il vous donne, et le certificat HTTPS suit.

## Revenir à la version d'avant

> Vous, à votre agent : Reviens à la version d'avant.

Dans les 30 minutes qui suivent une mise en ligne, la version d'avant revient en une seconde. Ensuite, en quelques secondes. Une fois la version d'avant revenue, votre agent lit ce qui a cassé dans les journaux de while, corrige et remet en ligne.

## Prochaines étapes

- [Mettre en ligne une appli Ruby on Rails et sa base PostgreSQL](/fr/guides/appli-rails/)
- [Mettre en ligne une API Node.js et sa base PostgreSQL](/fr/guides/api-node-postgresql/)
- [Comparer Heroku et while](/fr/comparatifs/while-vs-heroku/)
- [Comparer les hébergeurs qui ont un serveur MCP](/fr/comparatifs/hebergement-appli-claude-code/)

## Sources

1. [Heroku Dev Center, les principes d'exécution (le port donné par PORT)](https://devcenter.heroku.com/articles/runtime-principles), 2026-11-01
2. [Heroku sur GitHub, l'exemple Node.js avec Express (node-js-getting-started)](https://github.com/heroku/nodejs-getting-started), 2026-11-01
3. [Heroku Dev Center, les config vars](https://devcenter.heroku.com/articles/config-vars), 2026-11-01

## Questions

### Et mes add-ons ?

Base PostgreSQL, cache compatible Redis, stockage S3 et tâches planifiées ont leur équivalent dans while.

### Faut-il écrire un Dockerfile ?

Non, une appli Node.js, Python ou Go est reconnue d'office.

### Puis-je garder Heroku le temps de vérifier ?

Oui, votre appli tourne sur while à sa propre adresse avant que vous basculiez votre domaine.