Erreurs courantes

Le déploiement échoue avec le message : « Déploiement échoué. Raison : Aucun fichier index.html à la racine du site. »

Votre projet ne contient pas de fichier index.html à la racine. Sans ce fichier, Ivory ne sait pas quelle page afficher en premier.

Cela peut aussi se produire si votre index.html est placé dans un sous-dossier (par exemple mon-site/index.html), ou si vous avez oublié de l'inclure dans le fichier .zip.

• Vérifiez que votre projet contient bien un fichier index.html.
• Assurez-vous que ce fichier est à la racine, et non dans un sous-dossier.
• Si vous uploadez un .zip, ouvrez-le et vérifiez sa structure. Le index.html doit être directement dedans, pas dans un dossier parent.
• Si votre projet a une structure mon-site/index.html, Ivory la détecte automatiquement et l'aplatit. Vérifiez tout de même.

Avant tout déploiement, vérifiez toujours la structure de votre projet. Le index.html doit être à la racine.

Le déploiement échoue avec le message : « Déploiement échoué. Raison : Plusieurs fichiers index.html trouvés à la racine. »

Votre projet contient plus d'un fichier index.html à la racine. Cela peut arriver si vous avez copié-collé un dossier sans supprimer l'ancien, ou si vous avez fusionné deux projets.

• Ouvrez votre projet localement.
• Identifiez les fichiers index.html en double.
• Supprimez celui qui n'est pas nécessaire.
• Réuploadez le projet.

Un projet ne doit contenir qu'un seul fichier index.html à la racine. Pour les autres pages, utilisez des noms différents (about.html, contact.html, etc.).

Le déploiement échoue avec un message listant un ou plusieurs fichiers refusés, avec la mention « Extension non supportée ».

Ivory n'héberge que des fichiers statiques. Certaines extensions sont bloquées pour des raisons de sécurité : .php, .py, .rb, .exe, .dll, .sh, etc.

• Identifiez les fichiers refusés dans le message d'erreur.
• Supprimez-les de votre projet.
• Si vous avez besoin de ces fichiers pour le développement, gardez-les en local et n'uploadez que les fichiers statiques.

Avant d'uploader, vérifiez que votre projet ne contient que des fichiers HTML, CSS, JS, images, polices, ou autres fichiers statiques.

Le déploiement échoue avec la mention « Fichier interdit : .env » (ou .key, .pem, id_rsa, etc.).

Ces fichiers contiennent des informations sensibles (clés API, mots de passe, certificats). Ivory les bloque automatiquement pour éviter toute fuite de données.

• Supprimez ces fichiers de votre projet avant l'upload.
• Ne stockez jamais de secrets dans un projet hébergé publiquement.
• Si votre site a besoin de clés API, utilisez un service backend séparé.

Ajoutez ces fichiers à votre .gitignore si vous utilisez Git, et ne les incluez jamais dans un déploiement public.

Le déploiement échoue avec la mention « Dossier interdit : .git » (ou .svn, __MACOSX, etc.).

Ces dossiers contiennent des métadonnées inutiles pour un site web. Ils sont bloqués pour éviter d'alourdir le déploiement et d'exposer des informations internes.

• Supprimez ces dossiers de votre projet avant l'upload.
• Si vous utilisez Git, n'incluez pas le dossier .git dans votre .zip.
• Sur macOS, le dossier __MACOSX apparaît souvent dans les .zip. Supprimez-le.

Avant de zipper votre projet, nettoyez-le des dossiers de développement (.git, .svn, node_modules, etc.).

Le déploiement échoue avec la mention « Fichier sans extension non autorisé : nom_du_fichier ».

Ivory n'accepte que certains fichiers sans extension (CNAME, LICENSE, README, etc.). Les autres sont bloqués.

• Renommez le fichier en lui ajoutant une extension valide (.txt, .html, etc.).
• Ou supprimez-le s'il n'est pas nécessaire.

Évitez les fichiers sans extension dans vos projets web. Utilisez toujours une extension explicite.

Le déploiement échoue avec le message : « Espace saturé. Tu utilises X Mo sur Y Mo. »

Votre projet dépasse votre quota de stockage. Cela peut arriver si vous avez beaucoup de projets, ou si vos fichiers sont volumineux (images non optimisées, vidéos, etc.).

• Supprimez un projet inutilisé pour libérer de l'espace.
• Optimisez vos images avant l'upload.
• Minifiez vos fichiers CSS et JS.
• Si nécessaire, changez de plan pour augmenter votre quota.

Surveillez régulièrement votre utilisation de stockage depuis les Réglages. Consultez la page Stockage.

Le déploiement échoue avec la mention « Fichier invalide : nom_du_fichier ».

Un fichier a été corrompu lors de l'upload, ou n'a pas été correctement encodé en base64.

• Vérifiez le fichier sur votre ordinateur : peut-il s'ouvrir correctement ?
• Si le fichier est corrompu, restaurez une version saine.
• Réessayez l'upload.

Vérifiez toujours que vos fichiers s'ouvrent correctement en local avant de les uploader.

L'upload reste bloqué, échoue, ou affiche une erreur réseau.

Connexion internet instable, fichiers trop volumineux, ou charge temporaire sur l'infrastructure.

• Vérifiez votre connexion internet.
• Réduisez la taille de vos fichiers (compression, minification).
• Réessayez dans quelques minutes.
• Si le problème persiste, contactez le support.

Uploadez depuis une connexion stable, et privilégiez les fichiers compressés.

Le déploiement échoue avec un message technique générique.

Un problème est survenu sur l'infrastructure sous-jacente. Cela peut être temporaire.

• Réessayez dans quelques minutes.
• Si le problème persiste après 24 heures, contactez le support avec la date et l'heure de la tentative.

Ces erreurs sont rares et généralement temporaires. Aucune action préventive n'est nécessaire.

Le message « Le nom est déjà pris » s'affiche quand vous tapez un nom de projet.

Un autre utilisateur a déjà créé un projet avec ce nom. Les noms sont uniques sur toute la plateforme.

• Choisissez un autre nom.
• Utilisez les suggestions proposées automatiquement par Ivory.
• Ajoutez un suffixe unique (par exemple -2026, -pro, etc.).

Choisissez un nom suffisamment spécifique pour éviter les collisions.

Le message « Ce nom est réservé » s'affiche.

Certains noms sont réservés par Ivory pour des raisons techniques (admin, api, www, mail, etc.).

• Choisissez un autre nom.
• Ivory propose automatiquement une variante utilisable.

Évitez les noms génériques ou trop courts, qui sont souvent réservés.

Le message « Nom trop court » ou « Nom invalide » s'affiche.

Le nom contient des caractères non autorisés (majuscules, espaces, accents) ou est trop court (moins de 2 caractères).

• Utilisez uniquement des minuscules, chiffres et tirets.
• Assurez-vous que le nom fait au moins 2 caractères.

Relisez les règles de nommage avant de créer votre projet.

Vous êtes redirigé vers la page de connexion, ou un message « Session expirée » s'affiche.

Votre session Google a expiré. Le token d'authentification a une durée de validité limitée.

• Reconnectez-vous avec votre compte Google.
• Vérifiez que votre compte Google est toujours actif.

Reconnectez-vous régulièrement pour maintenir votre session active.

Le message « Connexion Google invalide » s'affiche.

Le token fourni par Google est expiré, corrompu, ou ne correspond pas au client d'Ivory.

• Déconnectez-vous et reconnectez-vous.
• Videz le cache de votre navigateur.
• Si le problème persiste, essayez un autre navigateur.

Utilisez un navigateur à jour et évitez les extensions qui modifient les requêtes.

Le message « Trop de requêtes. Réessaie dans un moment. » s'affiche.

Vous avez effectué trop d'actions en peu de temps. Ivory limite le nombre de requêtes par heure pour protéger la plateforme.

• Attendez quelques minutes.
• Réessayez.

Évitez de cliquer plusieurs fois rapidement sur les mêmes boutons.

Certaines fonctionnalités ne s'affichent pas, ou un message « Compte introuvable » apparaît.

Votre compte n'a pas encore été créé dans la base de données, ou a été supprimé.

• Reconnectez-vous : un compte sera automatiquement créé.
• Si vous avez supprimé votre compte, un nouveau sera créé à la prochaine connexion.

Aucune action spécifique nécessaire.

La suppression du compte échoue, ou reste bloquée.

Un problème technique est survenu lors de la suppression des projets ou des données associées.

• Réessayez.
• Si le problème persiste, contactez le support.

Supprimez vos projets un par un avant de supprimer votre compte, si vous en avez beaucoup.

Nzoko affiche : « Tu as utilisé tes X questions du jour. Reviens demain ! »

Vous avez atteint votre quota quotidien de questions.

• Attendez le renouvellement du quota.
• Ou passez à un plan supérieur pour augmenter votre quota.

Surveillez votre quota affiché en haut de la fenêtre de conversation.

Nzoko affiche : « 🌙 Nzoko est en repos pour aujourd'hui. »

La limite globale journalière de la plateforme a été atteinte. Cela peut arriver en cas de forte utilisation collective.

• Attendez le prochain cycle de renouvellement.
• Consultez la documentation en attendant.

Aucune action possible. Cette limite protège la disponibilité du service pour tous.

Nzoko ne répond pas, ou affiche « Nzoko est indisponible pour le moment. »

Un problème temporaire de connexion avec le service d'IA sous-jacent.

• Attendez quelques minutes.
• Réessayez.
• Si le problème persiste, contactez le support.

Aucune action spécifique.

Nzoko affiche « Question trop longue ».

Votre question dépasse la limite de 800 caractères.

• Reformulez votre question plus brièvement.
• Divisez-la en plusieurs questions plus courtes.

Posez des questions concises et précises.

Votre site s'ouvre mais affiche une page vide.

Plusieurs causes possibles : erreur dans le HTML, JavaScript bloquant, chemin incorrect vers les ressources, ou fichier index.html vide.

• Ouvrez la console du navigateur (F12) pour voir les erreurs.
• Vérifiez que le index.html contient du contenu valide.
• Vérifiez les chemins de vos fichiers CSS et JS.
• Réuploadez les fichiers corrigés.

Testez toujours votre site en local avant de le déployer.

Votre site s'affiche sans style. Le HTML apparaît brut.

Le chemin vers le fichier CSS est incorrect, ou le fichier CSS n'a pas été uploadé.

• Vérifiez que votre fichier CSS est bien inclus dans le projet.
• Vérifiez le chemin dans la balise <link> de votre HTML.
• Vérifiez la casse des noms de fichiers.

Utilisez des chemins relatifs simples et des noms de fichiers en minuscules.

Les images de votre site ne s'affichent pas. Un carré vide ou une icône de fichier cassé apparaît.

Chemin incorrect, image non uploadée, ou nom de fichier mal orthographié.

• Vérifiez que les images sont bien dans votre projet.
• Vérifiez les chemins dans vos balises <img>.
• Vérifiez la casse et l'orthographe des noms de fichiers.

Utilisez des chemins relatifs et évitez les espaces ou caractères spéciaux dans les noms de fichiers.

Certains liens de votre site mènent à une page introuvable (404).

Les pages cibles n'ont pas été uploadées, ou les liens pointent vers des chemins incorrects.

• Vérifiez que toutes les pages référencées existent dans votre projet.
• Vérifiez les chemins dans vos balises <a>.
• Réuploadez les fichiers manquants.

Testez tous les liens de votre site en local avant de le déployer.

Vos modifications n'apparaissent pas, même après un nouveau déploiement.

Votre navigateur affiche une version en cache de votre site.

• Forcez le rechargement : Ctrl+F5 (ou Cmd+Shift+R sur Mac).
• Utilisez le mode navigation privée.
• Videz le cache de votre navigateur.

Testez toujours vos modifications en navigation privée.

Dans la fenêtre de détail de votre projet, le lien permanent et le lien technique sont identiques. Les deux contiennent la partie aléatoire (ex : ih-f0jejei23.mon-site.pages.dev).

Un cas technique interne à l'infrastructure sous-jacente. Cela peut survenir à tout moment, et durer de quelques minutes à plusieurs mois. Cela n'affecte pas le fonctionnement de votre site.

• Copiez votre lien.
• Supprimez manuellement la partie aléatoire.
• Par exemple : https://ih-f0jejei23.mon-site.pages.dev devient https://ih-mon-site.pages.dev.
• Utilisez ce lien raccourci pour le partage.

Attention : ne supprimez que la partie aléatoire. Ne touchez pas au préfixe ih-, au nom du projet, ni à l'extension .pages.dev.

Aucune action préventive possible. Ce cas est rare et temporaire.

Le lien technique de votre projet ne s'ouvre pas, alors que le lien permanent fonctionne.

Le lien technique peut être obsolète, ou l'infrastructure peut ne plus répondre à ce lien spécifique.

• Utilisez toujours le lien permanent pour vos partages.
• Ignorez le lien technique s'il ne fonctionne pas.

Privilégiez systématiquement le lien permanent.

Le lien permanent de votre site semble avoir changé.

En principe, le lien permanent ne change jamais. Si vous constatez un changement, il s'agit probablement d'un affichage de lien technique au lieu du lien permanent.

• Vérifiez le lien depuis votre tableau de bord.
• Si le lien permanent a réellement changé, contactez le support.

Conservez toujours une copie du lien permanent de vos projets importants.

Le message « Espace insuffisant. Il manque X Mo. » s'affiche.

Votre déploiement dépasserait votre quota de stockage.

• Supprimez un projet inutilisé.
• Optimisez vos fichiers (images, CSS, JS).
• Changez de plan pour augmenter votre quota.

Surveillez votre utilisation depuis les Réglages.

Votre utilisation de stockage affichée semble inférieure ou supérieure à la réalité.

Le calcul peut prendre quelques minutes à se mettre à jour après un déploiement ou une suppression.

• Attendez quelques minutes et rafraîchissez la page.
• Si l'écart persiste, contactez le support.

Aucune action spécifique.

Le quota affiché ne correspond pas à votre plan.

Un changement de plan récent peut ne pas être encore reflété.

• Déconnectez-vous et reconnectez-vous.
• Si le problème persiste, contactez le support.

Aucune action spécifique.

Votre paiement Mobile Money échoue ou reste bloqué.

Plusieurs causes possibles : solde insuffisant, numéro incorrect, problème opérateur, limite de transaction atteinte.

• Vérifiez votre solde Mobile Money.
• Vérifiez le numéro destinataire.
• Réessayez après quelques minutes.
• Contactez votre opérateur si le problème persiste.

Vérifiez toujours les informations de paiement avant de valider.

Vous avez payé, mais votre compte n'est pas passé au plan supérieur.

Le paiement peut être en attente de vérification. Un délai de quelques minutes à quelques heures est possible.

• Attendez 24 heures.
• Si le problème persiste, contactez le support avec votre preuve de paiement.

Conservez toujours la preuve de votre paiement.

Vous avez payé deux fois pour la même période par erreur.

Une double validation, ou un clic répété sur le bouton de paiement.

• Contactez immédiatement le support avec vos deux preuves de paiement.
• Un remboursement du double paiement sera étudié.

Ne cliquez qu'une seule fois sur le bouton de paiement, et attendez la confirmation.

Le QR code généré ne redirige pas vers votre site.

Le QR code peut être mal scanné, ou le lien associé peut être incorrect.

• Vérifiez que le lien permanent de votre projet fonctionne.
• Testez le QR code avec une autre application de scan.
• Régénérez le QR code si nécessaire.

Testez toujours le QR code avant de l'imprimer ou de le partager.

Les statistiques de votre projet affichent 0 visite, même après plusieurs jours.

Votre site n'a peut-être pas encore reçu de visiteurs. Ou les statistiques peuvent prendre quelques minutes à se mettre à jour.

• Vérifiez que votre site est accessible publiquement.
• Visitez votre site vous-même pour tester.
• Attendez 24 heures avant de conclure à un problème.
• Si le problème persiste, contactez le support.

Partagez votre site pour générer des visites et tester les statistiques.

Le débogueur n'affiche aucun log.

Aucune erreur n'a été enregistrée pour votre compte, ou les logs ont été purgés.

• Attendez d'effectuer une action pour générer des logs.
• Si vous avez récemment rencontré une erreur, vérifiez que vous êtes connecté avec le bon compte.

Aucune action spécifique.

La suppression d'un projet échoue, ou affiche « Projet introuvable ».

Le projet a peut-être déjà été supprimé, ou une erreur technique est survenue.

• Rafraîchissez votre tableau de bord.
• Vérifiez que le projet apparaît bien dans votre liste.
• Si le problème persiste, contactez le support.

Aucune action spécifique.

Votre site est temporairement inaccessible, ou affiche un message de mise en veille.

Un trafic exceptionnellement élevé, ou une utilisation abusive des ressources, a déclenché une mise en veille temporaire pour protéger l'infrastructure.

• Attendez la fin de la mise en veille.
• Vous serez notifié par email.
• Si le problème persiste, contactez le support.

Évitez les pics de trafic soudains. Optimisez votre site pour réduire la charge serveur.