Build, scale, and manage user-facing Retrieval-Augmented Generation applications. home page
Search...
⌘K
Ask AI
Support
R2R GitHub
R2R GitHub
Search...
Navigation
Troubleshooting
Overview
Introduction
Documentation
API Reference
Cookbooks
SciPhi Cloud
Community
Getting Started
Installation
Quickstart
API & SDKs
Setup
Core Services
Ingestion
Knowledge Graph
Retrieval
Local LLMs
Deployment
Introduction
Cloud Providers
Troubleshooting
Overview
Common Installation Issues
Deployment Problems
Runtime Errors
Configuration Troubleshooting
Component-specific Issues
R2R Problems
Deep Dives
R2R Main
Providers
Other
On this page
Troubleshooting
R2R Troubleshooting Guide
Common Installation Issues
Docker Installation
Local System Installation
Deployment Problems
Cloud Deployments
Other
Runtime Errors
API-related Issues
Performance Issues
Configuration Troubleshooting
Environment Variables
Custom Configurations
Component-specific Issues
Postgres + pgvector
Hatchet
Debugging Tips
Getting Help
Troubleshooting
Overview
Learn how to debug R2R deployments
Troubleshooting
Have you encountered issues with deploying your R2R system? Have no fear our troubleshooting guide is here.
R2R Troubleshooting Guide
Common Installation Issues
Docker Installation
Issue:
Docker containers fail to start
Issue:
Missing environment variables
Issue:
Insufficient system resources
Local System Installation
Issue:
Dependency conflicts
Issue:
Service configuration
problems (Postgres, Hatchet)
Issue:
Unstructured.io
setup difficulties
Deployment Problems
Cloud Deployments
Issue:
Connection timeouts
Issue:
Insufficient instance resources
Issue:
Security group / firewall configuration
Other
Issue:
Port conflicts
Issue:
Database connection failures
Issue:
Local LLM integration issues
Runtime Errors
API-related Issues
Issue:
API endpoints not responding
Issue:
Unexpected API responses
Performance Issues
Issue:
Slow query responses
Issue:
High resource usage
Configuration Troubleshooting
Environment Variables
Issue:
Missing or incorrect API keys
Issue:
Incorrect database credentials
Custom Configurations
Issue:
TOML file syntax errors
Issue:
Incompatible configuration settings
Component-specific Issues
Postgres + pgvector
Issue:
Vector storage problems
Issue:
Connection string errors
Hatchet
Issue:
Workflow orchestration failures
Issue:
RabbitMQ connectivity issues
Debugging Tips
How to check R2R logs
)
Getting Help
Report issues on GitHub
Joining the Discord community for support
Was this page helpful?
Yes
No
GCP
Docker
Assistant
Responses are generated using AI and may contain mistakes.