Problèmes courants

Dans cette section, vous trouverez des solutions aux problèmes courants que vous pouvez rencontrer lors de l'auto-hébergement d'iHorizon, ainsi que des instructions détaillées pour les résoudre. Que vous soyez débutant ou utilisateur expérimenté, ces explications vous aideront à corriger votre configuration.

Si votre problème ne figure pas ici, n'hésitez pas à nous contacter sur notre communauté de support ou à ouvrir un ticket sur notre dépôt GitLab.

Could not find Chrome

Systèmes concernés : Linux, Windows, macOS

Cette erreur survient lorsque Puppeteer — une bibliothèque JavaScript utilisée par iHorizon pour générer des images, notamment pour le système de captcha et le module de musique — ne parvient pas à trouver le chemin vers Chrome ou Chromium sur votre machine. Cela est généralement dû à une installation manquante du navigateur ou à une configuration incorrecte du chemin.

"Could not find Chrome" error in the terminal

Correctif sur Linux

Deux méthodes sont disponibles. Utilisez celle qui convient le mieux à votre configuration.

Méthode 1 — Installeur intégré de Puppeteer (npx)

C'est la méthode la plus simple. Elle télécharge un binaire Chrome garanti compatible avec votre version de Puppeteer :

npx puppeteer browsers install chrome

Chrome sera téléchargé et Puppeteer le détectera automatiquement — aucune configuration supplémentaire n'est nécessaire.

Node.js est requis pour cette méthode

Si Node.js n'est pas installé, exécutez d'abord sudo apt install nodejs (sur les distributions basées sur Debian), ou suivez les instructions sur le site officiel de Node.js.

Méthode 2 — Flatpak (Chromium)

Utilisez cette méthode si vous préférez une installation système de Chromium ou si la méthode npx ne fonctionne pas dans votre environnement.

Étape 1 — Installez Flatpak (si ce n'est pas déjà fait). Les instructions d'installation sont disponibles sur le site officiel de Flatpak.

Étape 2 — Installez Chromium via Flatpak :

flatpak install org.chromium.Chromium

Si vous voyez l'erreur suivante :

error: No remotes refs found for 'org.chromium.Chromium'

Cela signifie qu'aucun dépôt Flatpak n'est configuré sur votre système. Initialisez d'abord le dépôt Flathub, puis relancez la commande d'installation :

flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Étape 3 — Créez un fichier .env (si vous ne l'avez pas déjà fait) et ajoutez la variable d'environnement suivante :

PUPPETEER_EXECUTABLE_PATH=/var/lib/flatpak/exports/bin/org.chromium.Chromium

Chromium aura un chemin différent si le dépôt/remote Flathub a été ajouté avec le paramètre --user

Lorsque vous ajoutez un dépôt/remote Flatpak avec le paramètre --user, c'est-à-dire en exécutant la commande suivante :

flatpak remote-add --if-not-exists --user flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Chromium aura un chemin d'exécutable complètement différent, car ce paramètre n'installera Chromium et les autres applications Flatpak que vous pouvez installer que dans votre répertoire home au lieu de votre répertoire root (et rendra ces applications disponibles uniquement sur le compte utilisateur où elles ont été installées). Dans ce cas, la variable d'environnement correcte sera :

PUPPETEER_EXECUTABLE_PATH=~/.local/share/flatpak/app/org.chromium.Chromium/current/active/export/bin/org.chromium.Chromium

Correctif sur Windows et macOS

Installez Google Chrome à partir de son site officiel. Puppeteer le détectera automatiquement.

(Oui, c'est tout ! 🤩)