Local Installation of LibreChat with Docker

For most scenarios, Docker Compose is the recommended installation method due to its simplicity, ease of use, and reliability.

Prerequisites

• Git
• Docker

Installation Steps

Follow these steps to set up LibreChat with the default configuration:

git clone https://github.com/danny-avila/LibreChat.git

cd LibreChat

cp .env.example .env

Note: If you’re using Windows, you might need to use copy instead of cp.

docker compose up -d

Update LibreChat

The following commands will fetch the latest LibreChat project changes, including any necessary changes to the docker compose files, as well as the latest prebuilt images.

Note: you may need to prefix commands with sudo according to your environment permissions.

docker compose down

# Linux/Mac
docker images -a | grep "librechat" | awk '{print $3}' | xargs docker rmi
 
# Windows (PowerShell)
docker images -a --format "{{.ID}}" --filter "reference=*librechat*" | ForEach-Object { docker rmi $_ }

git pull

docker compose pull

docker compose up

Additional Setup

Unlock additional features by exploring our configuration guides to learn how to set up:

• Custom endpoints
• Other advanced configuration options
• And more

This will enable you to customize your LibreChat experience with optional features.

see also:

• Docker Override
• User Authentication System Setup
• AI Setup
• Custom Endpoints & Configuration
• Manage Your MongoDB Database