File size: 1,187 Bytes
700a224 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
# Running on Docker
Pre-built Docker images are available:
- **`ghcr.io/huggingface/chat-ui-db`** - Includes MongoDB (recommended for quick setup)
- **`ghcr.io/huggingface/chat-ui`** - Requires external MongoDB
## Quick Start (with bundled MongoDB)
```bash
docker run -p 3000:3000 \
-e OPENAI_BASE_URL=https://router.huggingface.co/v1 \
-e OPENAI_API_KEY=hf_*** \
-v chat-ui-data:/data \
ghcr.io/huggingface/chat-ui-db
```
## With External MongoDB
If you have an existing MongoDB instance:
```bash
docker run -p 3000:3000 \
-e OPENAI_BASE_URL=https://router.huggingface.co/v1 \
-e OPENAI_API_KEY=hf_*** \
-e MONGODB_URL=mongodb://host.docker.internal:27017 \
ghcr.io/huggingface/chat-ui
```
Use `host.docker.internal` to reach MongoDB running on your host machine, or provide your MongoDB Atlas connection string.
## Using an Environment File
For more configuration options, use `--env-file` to avoid leaking secrets in shell history:
```bash
docker run -p 3000:3000 \
--env-file .env.local \
-v chat-ui-data:/data \
ghcr.io/huggingface/chat-ui-db
```
See the [configuration overview](../configuration/overview) for all available environment variables.
|