LibreChat

LibreChat

Docker app from pureelectricity's Repository

Overview

LibreChat: Enhanced ChatGPT Clone. Features: Agents, Anthropic, AWS, OpenAI, Azure, Gemini, AI model switching, message search, langchain, DALL-E-3, Multi-User Auth, and more.

PREREQUISITES:

  1. You must have a MongoDB container running (e.g., the official mongo docker).
  2. You must generate random hex strings for the CREDS_KEY, CREDS_IV, and JWT_SECRET below, or logins will fail.

CONFIGURATION:

  • This template uses Environment Variables for config.
  • The 'librechat.yaml' file is optional and not mapped by default to prevent boot errors. If you need advanced configuration (custom endpoints), create the file on your server first, then add a Host Path mapping manually: /mnt/user/appdata/librechat/librechat.yaml -> /app/librechat.yaml

Runtime arguments

Web UI
http://[IP]:[PORT:3080]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI PortPorttcp

The port to access the LibreChat interface.

Target
3080
Default
3080
Host BindingVariable

Required for Docker networking.

Target
HOST
Default
0.0.0.0
Client DomainVariable

The URL used to access the app. MUST include http:// or https://.

Target
DOMAIN_CLIENT
Default
http://[IP]:[PORT:3080]
Server DomainVariable

Usually the same as Client Domain.

Target
DOMAIN_SERVER
Default
http://[IP]:[PORT:3080]
MongoDB URIVariable

Required. Format: mongodb://[IP]:27017/LibreChat

Target
MONGO_URI
Crypto KeyVariable

Required. 64-character hex string. Run 'openssl rand -hex 32' to generate.

Target
CREDS_KEY
Crypto IVVariable

Required. 32-character hex string. Run 'openssl rand -hex 16' to generate.

Target
CREDS_IV
JWT SecretVariable

Required. Long random string for signing tokens.

Target
JWT_SECRET
JWT Refresh SecretVariable

Required. Long random string for refresh tokens.

Target
JWT_REFRESH_SECRET
OpenAI API KeyVariable

Optional. If set to 'user_provided', users can enter their own key in the UI.

Target
OPENAI_API_KEY
Default
user_provided
Image StoragePathrw

Persist uploaded images and avatars.

Target
/app/client/public/images
Default
/mnt/user/appdata/librechat/images
LogsPathrw

Container logs.

Target
/app/logs
Default
/mnt/user/appdata/librechat/logs
Install MeiliSearchVariable

Set to 'true' only if you have a separate MeiliSearch container running for chat history search.

Target
SEARCH
Default
false
MeiliSearch HostVariable

http://[IP]:7700

Target
MEILI_HOST
MeiliSearch KeyVariable

The master key from your MeiliSearch container.

Target
MEILI_MASTER_KEY
UIDVariable

Unraid Default User ID

Default
99
GIDVariable

Unraid Default Group ID

Default
100

Details

Repository
ghcr.io/danny-avila/librechat:latest
Last Updated2026-06-01
First Seen2025-09-01

Run LibreChat on Unraid.

LibreChat is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.