R2R Docker Installation

This guide will walk you through installing and running R2R using Docker, which is the quickest and easiest way to get started.

Prerequisites

Docker installed on your system. If you haven’t installed Docker yet, please refer to the official Docker installation guide.

Install the R2R CLI & Python SDK

First, install the R2R CLI and Python SDK:

$ pip install r2r

We are actively developing a distinct CLI binary for R2R for easier installation. Please reach out if you have any specific needs or feature requests.

Start R2R with Docker

Cloud LLM RAG

Local LLMs

Custom Configuration

Postgres comes bundled into the R2R Docker by default.

The above command will automatically pull the necessary Docker images and start all the required containers, including R2R, Postgres+pgvector.

The end result is a live server at http://localhost:7272 serving the R2R API.

In addition to launching a RESTful API, the R2R Docker also launches a applications at localhost:7273 and localhost:7274, which you can read more about here.

Stopping R2R

Safely stop your system by running r2r docker-down to avoid potential shutdown complications.

Next Steps

After successfully installing R2R:

Verify Installation: Ensure all components are running correctly by accessing the R2R API at http://localhost:7272/v2/health.
Quick Start: Follow our R2R Quickstart Guide to set up your first RAG application.
In-Depth Tutorial: For a more comprehensive understanding, work through our R2R Walkthrough.
Customize Your Setup: Configure R2R components with the Configuration Guide.

If you encounter any issues during installation or setup, please use our Discord community or GitHub repository to seek assistance.