Ce guide explique comment installer le bot de trading crypto Gekko sur une distribution Linux classique. Ce bot est un outil d’automatisation open source créé à l’origine par Mike van Rossum, pour l’achat/vente de cryptomonnaies sur les principales places de marché.

Les étapes détaillées se basent sur ma configuration personnelle (machine virtuelle Debian sur un NUC Intel avec vSphere), mais elles fonctionnent pour la plupart des distributions Linux modernes (et pour Windows via WSL) capables d’exécuter Node.js et npm.

Étape 1 : Installer les dépendances requises

Commencez par installer les dépendances de base. Ces commandes supposent que vous utilisez une distribution Linux récente basée sur Debian ou Ubuntu.

Installer Node.js

sudo apt-get install nodejs

Installer npm (s’il n’est pas déjà disponible)

sudo apt-get install npm

Installer Git

sudo apt-get install git

(Facultatif) Installer le gestionnaire de processus PM2
PM2 n’est pas indispensable, mais il vous aide à exécuter et surveiller les instances de Gekko en arrière‑plan.

sudo npm install pm2 -g

Astuce : Si vous souhaitez mettre à jour npm vers la dernière version :

sudo npm install -g npm@latest

Étape 2 : Cloner le dépôt Gekko et installer les dépendances

Téléchargez le code source de Gekko :

git clone git://github.com/askmike/gekko.git -b stable
cd gekko

Installez les dépendances de production de Gekko :

npm install --only=production

Avertissement :
Ne lancez PAS npm audit fix ni npm audit --force même si npm le suggère après l’installation.
Cela pourrait casser les dépendances de Gekko et nécessiter une réinstallation complète.

Installez les modules pour les différents marchés (exchanges) :

cd exchange
npm install --only=production
cd ..

Astuces :

• Attendez que chaque commande se termine ; des erreurs à cette étape indiquent généralement des problèmes de permissions ou une incompatibilité de version de Node.js.
• Si vous mettez à jour Node.js ou npm, pensez à supprimer le  node_modules dossier et à relancer  npm install --only=production.

Étape 3 : Configurer l’accès à l’interface web de Gekko

Par défaut, l’interface web de Gekko n’est accessible que depuis la machine locale. Pour y accéder depuis un autre appareil de votre réseau local, vous devrez modifier certains fichiers de configuration.

a) Modifiez web/vue/dist/UIconfig.js

• Ouvrez le fichier dans votre éditeur de texte. Recherchez :

api: {
  host: '127.0.0.1',
  port: 3000,
  timeout: 120000 // 2 minutes
},

• Remplacez par :

api: {
  host: '0.0.0.0',
  port: 3000,
  timeout: 600000 // 10 minutes
},

• Ensuite, trouvez :

ui: {
  ssl: false,
  host: 'localhost',
  port: 3000,
  path: '/'
},

• Remplacez par :

ui: {
  ssl: false,
  host: 'x.x.x.x', // replace with the IP address of your Gekko server
  port: 3000,
  path: '/'
},

b) Modifiez web/vue/public/UIconfig.js

• Trouvez :

api: {
  host: '127.0.0.1',
  port: 3000,
  timeout: 120000 // 2 minutes
},

• Remplacez par :

api: {
  host: '127.0.0.1',
  port: 3000,
  timeout: 600000 // 10 minutes
},

Remarque : Augmenter le délai d’expiration de 2 à 10 minutes est facultatif, mais peut aider si vous subissez des déconnexions de l’interface.

Avertissement de sécurité :

L’interface web de Gekko n’a aucune authentification ni protection. Exposez cette interface uniquement sur des réseaux privés de confiance !
Ne redirigez jamais le port 3000 sur un serveur accessible depuis Internet, sinon n’importe qui pourrait accéder à votre Gekko.

Une fois les fichiers sauvegardés, vous pourrez accéder à l’interface Gekko à l’adresse :
http://x.x.x.x:3000
(Remplacez x.x.x.x par l’adresse IP du serveur.)

Étape 4 : Lancer et gérer l’interface web de Gekko

Lancez manuellement l’interface Gekko :

node gekko --ui

Vous pouvez maintenant ouvrir http://x.x.x.x:3000 dans votre navigateur (remplacez x.x.x.x par l’adresse IP de votre serveur).
Si la configuration a réussi, l’interface web de Gekko devrait s’afficher.

(Facultatif) Gérer l’interface Gekko avec pm2

Pour exécuter et surveiller Gekko en arrière‑plan — même après vous être déconnecté ou avoir fermé le terminal — utilisez pm2.

Exemple de script de démarrage (start_ui.sh) :

#!/bin/bash
rm ui_logs/*
pm2 start gekko.js --name gekko_ui --log-date-format="YYYY-MM-DD HH:mm Z" -e ui_logs/ui_err.log -o ui_logs/ui_out.log -- --ui --max_old_space_size=8096

• Rendez le script exécutable :

chmod 755 start_ui.sh

• Utilisez‑le pour lancer l’interface Gekko :

./start_ui.sh

Surveillez et gérez avec pm2 :

• Listez tous les processus pm2 et récupérez leurs noms et identifiants :

pm2 ls

• Affichez les journaux des processus :

pm2 log <id>

• Arrêtez l’instance de l’interface :

pm2 stop gekko_ui
pm2 stop <id>

• Supprimez un processus arrêté de pm2 :

pm2 delete gekko_ui
pm2 delete <id>

Astuce :
PM2 offre de nombreuses autres commandes — consultez la documentation officielle pour des fonctionnalités avancées.

Alternative : Installer Gekko sur Windows (en utilisant WSL)

Pour exécuter Gekko sous Windows de la manière la plus simple (et la plus sûre), utilisez le Sous‑système Windows pour Linux (WSL). Cela vous permet d’installer un environnement Debian ou Ubuntu complet à l’intérieur de Windows et de suivre exactement les mêmes étapes que sous Linux.

1. Installez WSL et une distribution Linux

• Suivez les instructions officielles de Microsoft :
  • Install WSL (Windows 10/11)
  • Set up Ubuntu on WSL

2. Ouvrez votre terminal WSL (Debian/Ubuntu)
Vous aurez accès à bash et à un environnement Linux standard.

3. Suivez toutes les étapes décrites ci‑dessus

• Vous pouvez maintenant répéter toutes les instructions d’installation pour Linux : installer les dépendances, cloner le dépôt, installer les modules npm, configurer et démarrer l’interface.
• Accédez à l’interface via votre navigateur à l’adresse http://localhost:3000 (ou votre IP locale Windows), comme pour Linux.

Remarque : Si vous devez accéder à l’interface depuis un autre appareil, vérifiez que les paramètres de votre pare‑feu autorisent les connexions au port 3000 dans votre environnement WSL.

Dernières étapes, prochaines actions et autres ressources

Félicitations — votre bot de trading Gekko est maintenant installé et l’interface web est accessible sur votre réseau local !

Pour des usages avancés et d’autres sujets liés à l’automatisation et au trading, consultez ces autres ressources sur ce blog :

• Exécution et réglage des stratégies de trading :
  → Personnalisation d’une stratégie Gekko
• Automatisation des backtests et de l’optimisation :
  → Automatiser le backtesting des paramètres de stratégies Gekko (avec Gekkoga)
• Déploiement en cloud et virtualisation :
  → Comment créer une VM Amazon EC2 « small » et automatiser le déploiement de Gekko
  → Lancer Gekkoga sur une machine Spot EC2 haut de gamme
• Utilisation quotidienne de Gekko et dépannage :
  → Utilisation du bot Gekko

Vos commentaires, retours et rapports de bugs sont toujours les bienvenus ci‑dessous :

• Ce guide a-t-il fonctionné pour vous ?
• Avez-vous rencontré des obstacles ou souhaitez-vous un tutoriel sur un autre sujet ?
• Partagez vos astuces et vos résultats !

Autres lectures recommandées

• Surveillance de la consommation d’électricité avec Jeedom et un modem USB sur IP
• Installation et surveillance d’un onduleur et de la batterie d’un ordinateur portable local avec Jeedom/Debian
• Tutoriel rapide : installer Raspbian Debian sur un Raspberry Pi (Zero)

Bon trading, codage et automatisation ! Votre expérience profite à toute la communauté.