LibreChat

Docker

How to install LibreChat locally with Docker

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

Prerequisites


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

Access LibreChat!

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:

How is this guide?

On this page