Skip to main content

Support

Get help from the Trix team. Find contact options, community resources, and troubleshooting guides.

Get Help

We're here to help you succeed with Trix. Choose the support channel that best fits your needs.

Response Times

Our support team is available Monday through Friday, 9am-6pm PST. Response times vary by plan:

PlanSupport ChannelsResponse TimeSeverity Handling
FreeCommunity forum, DiscordBest effort—
ProEmail, Community, Discord24 hoursStandard priority
MaxEmail, Slack Connect8 hoursHigh priority
EnterprisePriority support2 hoursCritical priority

Critical issues affecting production are prioritized regardless of plan. Include [URGENT] in your subject line for time-sensitive matters.

Common Issues

Before contacting support, check these common solutions:

Authentication Problems

ErrorCauseSolution
invalid_api_keyAPI key is incorrect or malformedCheck for typos, ensure no extra whitespace
expired_api_keyAPI key has expiredGenerate a new key with trix keys create
missing_api_keyNo API key providedSet TRIX_API_KEY environment variable
Terminal
# Check authentication status
trix auth status

# Re-authenticate if needed
trix auth login

# Verify API key is set
echo $TRIX_API_KEY

Connection Issues

ErrorCauseSolution
connection_timeoutNetwork connectivity problemsCheck internet, firewall settings
ssl_errorSSL/TLS certificate issuesUpdate CA certificates, check system time
dns_resolution_failedCannot resolve api.trixdb.comCheck DNS settings, try Google DNS (8.8.8.8)
Terminal
# Run diagnostics
trix doctor

# Test API connectivity
curl -I https://api.trixdb.com/health

# Check DNS resolution
nslookup api.trixdb.com

Rate Limit Issues

If you're hitting rate limits frequently, see our Rate Limits guide for best practices on handling and avoiding limits.

SDK Issues

IssueSolution
Module not foundEnsure package is installed: pip install trixdb or npm install @trixdb/client
Type errorsUpdate to latest version, check TypeScript configuration
Async/await issuesEnsure proper async handling, check runtime supports async

Diagnostic Tools

Use these tools to gather information before contacting support:

Terminal
# Run comprehensive diagnostics
trix doctor

# Get detailed system info
trix doctor --verbose

# Export diagnostic report
trix doctor --export diagnostics.json
Terminal
# Enable verbose logging
trix recall "test query" -vvv

# Or set environment variable
export TRIX_LOG_LEVEL=debug
trix recall "test query"

# View request/response details
export TRIX_DEBUG=true
trix remember "test memory"

Contacting Support

When reaching out for help, include these details for faster resolution:

Include in Your Request
  • SDK/CLI version (trix version)
  • Programming language and version
  • Operating system and version
  • Error message or code (complete text)
  • Steps to reproduce the issue
  • Diagnostic report (trix doctor --export)

Email Template

support-request.txt
Subject: "[Issue Type] Brief description"

Environment:
  Trix SDK/CLI: v1.4.0
  Language: Python 3.11 / TypeScript 5.0
  OS: macOS 14.1 / Ubuntu 22.04

Issue: |
  Describe what you're trying to do and what's
  happening instead.

Error Message: |
  Paste complete error message here

Steps to Reproduce:
  - First step
  - Second step
  - See error

What I've Tried:
  - Solution attempt 1
  - Solution attempt 2

Attachments:
  - diagnostics.json (from trix doctor --export)

Service Status

Check the current status of Trix services and subscribe to incident updates:

During planned maintenance, the API may return 503 Service Unavailable. We schedule maintenance during low-traffic hours (Sundays 2-4am PST) when possible.

Additional Resources

Explore these resources to learn more about Trix:

Enterprise Support

Enterprise plans include enhanced support options tailored to your needs:

Priority Support

Faster response times and priority handling for your support requests.

Custom SLA

Uptime guarantees and response time commitments tailored to your requirements.

Dedicated Infrastructure

Isolated deployments with custom data residency and compliance configurations.

Interested in Enterprise? Contact [email protected] to discuss custom plans and enterprise features.

Feature Requests

Have an idea for improving Trix? We'd love to hear from you: