Installer le client

Ce que fait le client

• Il tourne à côté de votre base, sur une machine qui peut l'atteindre.
• Il se connecte avec le rôle en lecture seule que vous créez (voir le démarrage rapide).
• Il collecte les données de performance sur place et n'envoie que celles-ci à Wakoo : durées, statistiques, forme des requêtes avec toutes les valeurs masquées, et plans d'exécution. Jamais les lignes de vos tables. Voir Sécurité et données.
• C'est aussi la commande wakoo que vous utilisez depuis votre terminal.

Rien n'est à installer sur le serveur de base lui-même avec un service managé comme Supabase, Neon ou Amazon RDS : le client s'y connecte par le réseau.

Où le faire tourner

• Pour une question ponctuelle, votre propre machine suffit, tant qu'elle atteint la base.
• Pour une surveillance continue, faites-le tourner sur une machine toujours allumée qui atteint la base : Wakoo ne surveille que tant que le client tourne.

Installer

Suivez les étapes pour votre plateforme ci-dessous, sur la machine qui fera tourner le client.

macOS / Linux

curl -fsSL https://wakoo.ai/install.sh | sh

Windows (PowerShell)

irm https://wakoo.ai/install.ps1 | iex

Docker

docker run -d --name wakoo-client --restart unless-stopped wakoo/client

Connectez-vous ensuite avec wakoo login (voir ci-dessous).

Bloqué ? Parlez à l'équipe : une personne vous aide à l'installer.

Se connecter avec wakoo login

Le client se connecte via votre navigateur, sans jeton à copier :

wakoo login

1. La CLI ouvre votre navigateur sur wakoo.ai/cli/authorize et affiche un code court, par exemple ABCD-EFGH.
2. Dans le navigateur (connectez-vous d'abord si besoin), vérifiez que le code et le nom de la machine correspondent à ce que vous voyez dans votre terminal. N'autorisez que si vous venez de lancer wakoo login vous-même.
3. Choisissez l'espace de travail que le client doit utiliser, puis autorisez.

Le code expire après 10 minutes ; dans ce cas, relancez wakoo login.

Une fois autorisé, le client reçoit son propre jeton d'accès personnel, nommé d'après votre machine (CLI on <hostname>), avec les droits read et follows:write, valable 90 jours. Vous pouvez le voir et le révoquer à tout moment dans Compte, Jetons d'accès et MCP.

Voir votre premier diagnostic

Une fois le client connecté à votre base, ouvrez l'app Wakoo : votre premier diagnostic y apparaît. Vous pouvez aussi poser vos questions depuis le terminal, ou depuis votre agent IA via MCP (voir Agents IA et MCP).

Options de déploiement

En Free, Pro et Team, le client envoie ses données de performance au cloud Wakoo, hébergé en Suisse. En Enterprise, Wakoo peut aussi tourner isolé du réseau (air-gapped) ou sur vos propres serveurs : dans ce cas, rien ne sort de votre réseau. Voir Offres et limites.