Troubleshooting
Diagnosis and resolution of common problems
Part of: How-To Guide
7 pages
Authentication Errors — TerminusDB Troubleshooting
Fix authentication errors with TerminusDB including wrong credentials, password vs key parameter confusion, API key format issues, and permission denied errors.
Connection Failures — TerminusDB Troubleshooting
Diagnose and fix connection failures when connecting to TerminusDB, including Docker networking issues, wrong ports, browser fetch errors, and timeouts.
Data Model Mismatches — TerminusDB Troubleshooting
Fix data model issues in TerminusDB including wrong @id format, Set vs Array confusion, Optional field handling, and @key strategy problems.
Handle SSL Certificate Errors in the Python Client
How to suppress or resolve SSL certificate verification errors when connecting the TerminusDB Python client to local or self-signed TLS instances.
Query Errors — TerminusDB Troubleshooting
Fix common WOQL and GraphQL query errors in TerminusDB including the anyuri vs string type mismatch, unbound variables, empty results, and path query syntax issues.
Schema Validation Errors — TerminusDB Troubleshooting
Diagnose and fix schema validation errors in TerminusDB including type mismatches on insert, missing required fields, class not found, and enum validation failures.
Troubleshooting Document ID Migration
How to fix subdocument ID prefix mismatches after schema changes using the ChangeKey migration operation.