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 https://github.com/LibreChat-AI/LibreChat.

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 https://github.com/LibreChat-AI/LibreChat.git

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.

Notes:

• 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.
     • For an in-depth environment configuration, see the .env File Configuration Guide.

3. Start the Application:

   • Run the following command:

   docker compose up -d

Step 4. Start Chatting

LibreChat is now running, but it needs an account and a model before it can answer anything:

1. Open http://localhost:3080 in your browser.
2. Register an account on the login page.
3. Add an API key for the provider you want to use.

Follow Your First Chat for these steps in detail, including what to do when no model answers.

Additional Links

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

• Updating LibreChat
  • Instructions on how to update this setup with the latest changes to LibreChat.
• Configuring AI Providers
  • Configure OpenAI, Google, Anthropic, and OpenAI Assistants
• Configuring a Custom Endpoint
  • Configure services such as Deepseek, OpenRouter, Ollama, Mistral AI, Databricks, groq, and others.
  • Click here for a list of known, compatible services.
• Environment Configuration
  • Read for a comprehensive look at the .env file.
• librechat.yaml File Configuration
  • Configure custom rate limiters, file outputs, and much more with the librechat.yaml file.
• Ubuntu Docker Deployment Guide
  • Read for advanced Docker setup on a remote/headless server.
• Setup the Azure OpenAI endpoint
  • Configure multiple Azure regions and deployments for seamless use with LibreChat.