From fe57f09d48cee8442eb482d602b9dce35d5ae602 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 10 Nov 2025 11:24:36 -0500 Subject: [PATCH] quickstart-install- --- docs/docs/get-started/quickstart.mdx | 44 ++++++++++++++++++++++++++-- docs/sidebars.js | 10 +++---- 2 files changed, 47 insertions(+), 7 deletions(-) diff --git a/docs/docs/get-started/quickstart.mdx b/docs/docs/get-started/quickstart.mdx index 92ed71c8..6ab08639 100644 --- a/docs/docs/get-started/quickstart.mdx +++ b/docs/docs/get-started/quickstart.mdx @@ -11,7 +11,47 @@ Get started with OpenRAG by loading your knowledge, swapping out your language m ## Prerequisites -- Install and start OpenRAG with the [TUI](/install) or [Docker](/get-started/docker) +:::tip +This quickstart uses a minimal setup to demonstrate OpenRAG's core functionality. After you complete the quickstart, it is recommended that you reinstall OpenRAG with your preferred configuration because some settings are immutable after initial setup. For all installation options, see [Install OpenRAG with TUI](/install) and [Install OpenRAG with containers](/docker). +::: + +Install OpenRAG with the automatic installer. +The script detects and installs uv, Docker/Podman, and Docker Compose prerequisites, and then starts OpenRAG with `uvx`. + + 1. Create a directory to store the OpenRAG configuration files: + ```bash + mkdir openrag-workspace + cd openrag-workspace + ``` + + 2. Run the installer: + ```bash + curl -fsSL https://docs.openr.ag/files/run_openrag_with_prereqs.sh | bash + ``` + + The TUI creates a `.env` file and docker-compose files in the current working directory, and then starts OpenRAG. + + 3. Select **Basic Setup**. + 4. To generate a password for OpenSearch, click **Generate Passwords**. + The other fields aren't required. + 5. To start OpenRAG, click **Start All Services**. + Startup pulls container images and runs them, so it can take some time. + When startup is complete, the TUI displays the following: + ```bash + Services started successfully + Command completed successfully + ``` + 6. To open the OpenRAG application, navigate to the TUI main menu, and then click **Open App**. + Alternatively, in your browser, navigate to `localhost:3000`. + 7. For your model provider, select **OpenAI**. + 8. In the **OpenAI API key** field, paste your OpenAI API key. + The default model settings are fine for the quickstart. + 9. To confirm your provider settings, click **Complete**. + 10. To complete onboarding, click **What is OpenRAG**, and then click **Add a document**. + Alternatively, click