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