Installer Freqtrade sur un VPS avec Docker

Freqtrade est un bot de trading crypto open source écrit en Python : il applique votre stratégie sur les plateformes d'échange, 24h/24, en simulation ou avec des fonds réels. Pour qu'il ne rate aucune bougie, il doit tourner sur une machine toujours allumée. Ce guide installe Freqtrade avec Docker sur un VPS Linux, du premier lancement en simulation jusqu'à l'interface web, avec les règles de sécurité indispensables pour vos clés API.

1. Quel VPS choisir

Prenez une distribution Debian ou Ubuntu récente. L'adresse IP fixe du VPS vous servira à restreindre vos clés API.

2. Installer Docker

Connecté en root, installez Docker avec le script officiel, puis vérifiez :

curl -fsSL https://get.docker.com | sh
docker compose version

3. Récupérer Freqtrade

Freqtrade fournit un fichier Docker Compose prêt à l'emploi :

mkdir ft_userdata && cd ft_userdata
curl https://raw.githubusercontent.com/freqtrade/freqtrade/stable/docker-compose.yml -o docker-compose.yml
docker compose pull
docker compose run --rm freqtrade create-userdir --userdir user_data
docker compose run --rm freqtrade new-config --config user_data/config.json

La dernière commande pose quelques questions : plateforme, devise de mise, montant par trade. Répondez oui au mode simulation (dry-run) : le bot utilisera un portefeuille fictif.

4. Lancer le bot en simulation

Le fichier Compose lance par défaut la stratégie d'exemple SampleStrategy, copiée dans user_data/strategies. Démarrez le bot en arrière-plan :

docker compose up -d
docker compose logs -f

Le conteneur redémarre seul après une erreur ou un redémarrage du VPS. Pour utiliser votre propre stratégie, placez son fichier dans user_data/strategies et remplacez SampleStrategy par son nom dans docker-compose.yml, puis relancez avec docker compose up -d.

5. Tester une stratégie sur l'historique

Avant de laisser tourner une stratégie, même en simulation, mesurez son comportement passé :

docker compose run --rm freqtrade download-data --exchange binance -t 5m --days 90
docker compose run --rm freqtrade backtesting --strategy SampleStrategy -i 5m

Adaptez la plateforme et l'unité de temps à votre configuration. Un bon résultat passé ne garantit rien : méfiez-vous des stratégies sur-optimisées, qui collent à l'historique et échouent ensuite.

6. L'interface FreqUI, sans l'exposer

Activez le serveur d'API dans user_data/config.json (bloc api_server : enabled à true, un nom d'utilisateur, un mot de passe long et une clé jwt_secret_key aléatoire). Le fichier Compose publie le port sur 127.0.0.1:8080 uniquement, ce qui est voulu. Depuis votre ordinateur, ouvrez un tunnel SSH :

ssh -L 8080:127.0.0.1:8080 root@IP_DU_VPS

puis ouvrez http://127.0.0.1:8080 dans votre navigateur. Vous pouvez aussi recevoir les alertes et piloter le bot depuis Telegram, avec le bloc telegram de la configuration.

7. Passer en réel : la sécurité des clés API

• Créez une clé dédiée au bot, avec le droit de trading uniquement. Jamais le droit de retrait.
• Restreignez la clé à l'adresse IP du VPS dans les réglages de la plateforme : volée, elle ne servira à rien ailleurs.
• Passez "dry_run": false seulement après plusieurs semaines de simulation cohérentes avec le backtest, et commencez avec un petit montant.
• Protégez le serveur : connexion SSH par clé, pare-feu et mises à jour régulières.
• Vérifiez les conditions de la plateforme pour votre pays et pour un serveur situé en France : certaines limitent l'accès selon la localisation.

8. Mettre à jour

docker compose pull
docker compose up -d

Lisez les notes de version avant une mise à jour importante : une stratégie peut demander une adaptation.

Questions fréquentes