Common Errors

Linux app does not start

Symptom: PentestPath does not launch, or crashes immediately after the splash screen.

Cause: Missing WebKitGTK runtime dependency required by the Tauri runtime.

Solution: Install the required dependencies for your distribution.

On Debian or Ubuntu:

sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 libayatana-appindicator3-1

On Fedora:

sudo dnf install webkit2gtk4.1

If you use the AppImage format, also make sure it is marked executable:

chmod +x PentestPath_*.AppImage

Vault unlock fails after app update

Symptom: The vault password prompt appears but the correct password is rejected after updating.

Cause: Rare edge case where vault state is inconsistent after a migration.

Solution: Try restarting the app fully. If the issue persists, review the Vault Reset procedure before taking any destructive action.

Team Mode relay fails to connect

Symptom: PentestPath shows a connection error when trying to reach the relay.

Check the following:

• The relay process is running and listening on the expected port.
• The endpoint URL in PentestPath matches the actual relay address.
• If using wss://, TLS is correctly terminated by the reverse proxy with a valid certificate.
• Firewalls or security groups allow WebSocket traffic on the relay port.
• All clients are connecting to the same endpoint.

Use ws:// only for local or trusted test environments. See Team Mode for deployment details.

License does not activate

See License Activation for a dedicated troubleshooting flow.

AI Assistant cannot connect

Symptom: The AI Assistant panel shows a connection error or returns no models.

Check:

• Ollama is running locally.
• The endpoint URL configured in PentestPath is correct (default: http://localhost:11434).
• At least one model is installed in Ollama (ollama list).
• Your current edition includes AI Assistant (Pro only).

Arsenal command has unresolved placeholders

Some command cards contain placeholders that are not fully substituted automatically. Review the final command before execution and replace any remaining values manually. See Arsenal Variables for the full list of what is and is not resolved.