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