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
Fix SSLCertVerificationError when the TerminusDB Python client connects to a local or self-signed server: use a CA bundle, export the cert, or skip checks.
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.