Quick Start
Local Setup

Local Setup Guide

This is a condensed version of our Local Installation Guide

Step 1. Download the Project

Manual Download

  1. Go to the Project Page: Visit

  2. Download the ZIP File: Click the green “Code” button, then click “Download ZIP.”

  3. Extract the ZIP File: Find the downloaded ZIP file, right-click, and select “Extract All…“.

Using Git

Run the following git command in your terminal, from the desired parent directory:

git clone

Step 2. Install Docker

  1. Download: Go to Docker Desktop Download Page and download Docker Desktop.
  2. Install: Open the installer and follow the instructions.
  3. Run: Open Docker Desktop to ensure it is running.


  • Docker Desktop is recommended for most users. If you are looking for an advanced docker/container setup, especially for a remote server installation, see our Ubuntu Docker Deployment Guide.
  • You may need to restart your computer after installation.

Step 3. Run the App

  1. Navigate to the Project Directory

  2. Create and Configure .env File:

    • Copy the contents of .env.example to a new file named .env.
    • Fill in any necessary values.
  3. Start the Application:

    • Run the following command:
    docker compose up


That’s it! You should now have LibreChat running locally on your machine. Enjoy!

Additional Links

Explore more about LibreChat and how to configure it to your needs.