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

Assistant

Responses are generated using AI and may contain mistakes.