Dépannage

Problèmes courants et comment les résoudre. Si quelque chose n'est pas couvert ici, consultez la FAQ.

Configuration et compatibilité

La vérification de compatibilité affiche un problème bloquant. Votre système d'exploitation ou sa version n'est pas pris en charge. Vérifiez les minimums dans Prérequis système : macOS 12+, Windows 10 build 17763+/11, ou un Linux moderne 64 bits dérivé de Debian. Mettez à jour votre OS et cliquez sur Revérifier.

La vérification de compatibilité affiche un avertissement. Généralement peu de RAM (moins de 8 Go) ou peu de cœurs CPU (moins de 4). Vous pouvez continuer, mais les longues missions seront plus lentes. 16 Go de RAM est la cible confortable.

Téléchargement du runtime

Le téléchargement du runtime est lent ou se bloque. Le runtime Pro est volumineux (jusqu'à ~20 Go). Le téléchargement reprend en cas d'interruption — laissez l'écran de configuration ouvert, ou rouvrez-le, et il continue là où il s'était arrêté. Assurez-vous d'avoir assez de disque libre (~25 Go) et une connexion stable.

Pas assez d'espace disque. Libérez de l'espace pour disposer d'environ 25 Go, puis réessayez. Voir Emplacements des données pour l'emplacement de stockage du runtime.

macOS

« AgentRidge ne peut pas être ouvert » / développeur non identifié. Ouvrez Réglages Système → Confidentialité et sécurité, trouvez l'avis concernant AgentRidge et cliquez sur Ouvrir quand même, puis relancez. Voir le guide d'installation macOS.

L'agent ne peut pas agir / les autorisations semblent refusées. Confirmez que Accessibilité et Accès complet au disque sont activés pour AgentRidge dans Réglages Système → Confidentialité et sécurité, puis cliquez sur Vérifier à nouveau à l'étape Autorisations.

Windows

SmartScreen bloque l'application. Cliquez sur Informations complémentaires → Exécuter quand même au premier lancement.

L'installateur ou l'application demande des droits administrateur. C'est attendu — AgentRidge s'installe pour toute la machine et les opérations autorisées peuvent nécessiter l'élévation. Choisissez Oui. Voir le guide d'installation Windows.

Linux

L'AppImage ne démarre pas. Rendez-la exécutable (chmod +x) et assurez-vous que FUSE est disponible (sudo apt install libfuse2 sur Ubuntu). En repli, extrayez-la avec --appimage-extract et lancez le binaire à l'intérieur. Voir le guide d'installation Linux.

Bibliothèques manquantes sur une image minimale. Le .deb tire ses dépendances via apt. Sur une installation minimale ou serveur, vous aurez peut-être besoin d'une pile bureau/GTK. Préférez le .deb sur Ubuntu/Debian pour que les dépendances se résolvent automatiquement.

Missions

Le mode Attaquant ne se lance pas. Le mode Attaquant nécessite un abonnement Pro actif. Avec l'essai gratuit, lancez en mode Auditeur, ou passez à Pro.

Le bouton de lancement est désactivé. Le brief n'est pas encore valide : il vous faut un nom de client, au moins une cible (IP, URL ou CIDR LAN), au moins un cas de mission, et la confirmation d'autorisation. Voir Nouvelle mission.

Une mission semble bloquée sur une étape. AgentRidge est conçu pour continuer à travailler même si une sous-étape cale — il documente le blocage, change de technique et poursuit le reste du périmètre. Regardez le flux Activité pour voir ce qu'il fait.

Compte et licence

Mes fonctionnalités Pro n'apparaissent pas après la mise à niveau. Les droits se rafraîchissent à la prochaine vérification. Rouvrez l'application (ou la vue compte/offre) pour qu'elle relise l'état de votre abonnement.

Ensuite : FAQ →