Open WebUI Docker Image
Minimal multi-arch Docker image for Open WebUI - a user-friendly interface for LLMs
The openwebui Docker image provides a user-friendly interface for Large Language Models that supports Ollama, OpenAI API, and more. It's designed to be minimal, secure, and easy to set up.
| Feature | Details |
|---|---|
| 🏋️ Targets | linux/amd64 (ARM support coming soon) |
| 🎯 Size | Minimized image size |
| 🔐 CVEs fixed | Automated nightly via GitHub Actions |
| 📦 Docker Hub | dockerbuildcom/openwebui |
| 🔗 GitHub | GitHub Repository |
Quick Start
Basic usage:
docker run -d -p 3000:8080 \
-v open-webui:/data \
--name open-webui \
dockerbuildcom/openwebui:latestAccess the web interface at http://localhost:3000
Why Use Our Open WebUI Image?
This image focuses on minimalism, security, and reliability. It provides a streamlined version of Open WebUI with regular updates and security patches. Compared to the official image, our version offers:
- Smaller image size for faster downloads
- Regular security scans to ensure CVE vulnerabilities are patched
- Simplified configuration with sensible defaults
- Multi-architecture support (amd64) with ARM support coming soon
Usage Examples
Basic Usage
Run a standalone Open WebUI instance:
docker run -d -p 3000:8080 \
-v open-webui:/data \
--name open-webui \
dockerbuildcom/openwebui:latestWith Ollama on the Same Host
Connect to Ollama running on the same machine:
docker run -d -p 3000:8080 \
-v open-webui:/data \
-e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
--add-host=host.docker.internal:host-gateway \
--name open-webui \
dockerbuildcom/openwebui:latestWith Ollama on a Different Server
Connect to Ollama running on a remote server:
docker run -d -p 3000:8080 \
-v open-webui:/data \
-e OLLAMA_BASE_URL=https://your-ollama-server.com \
--name open-webui \
dockerbuildcom/openwebui:latestRate-Limit Friendly Mirror
For environments with Docker Hub rate limits, you can also pull from GitHub Container Registry:
# Pull from GHCR instead of Docker Hub
docker pull ghcr.io/dockerbuildcom/openwebui:latestEnvironment Variables
Customize your Open WebUI instance with these environment variables:
| Variable | Default | Description |
|---|---|---|
| PORT | 3000 | The port OpenWebUI will listen on inside the container |
| OLLAMA_BASE_URL | /ollama | Base URL for Ollama integration |
| OPENAI_API_BASE_URL | OpenAI API URL (for compatible services) | |
| OPENAI_API_KEY | Optional OpenAI API key | |
| WEBUI_SECRET_KEY | Optional secret key for additional security |
Persisting Data
Mount a volume to /data to persist your Open WebUI data, including database, user settings, and documents:
# Create a named volume
docker volume create open-webui
# Use the volume when starting the container
docker run -d -p 3000:8080 \
-v open-webui:/data \
--name open-webui \
dockerbuildcom/openwebui:latestNote
Without a persistent volume, all your data and settings will be lost when the container is removed.
Security Scan
Our images are regularly scanned for vulnerabilities using Docker Scout:
- name: Scan with Docker Scout
uses: docker/scout-action@v1
with:
image: dockerbuildcom/openwebui:latest
sarif-file: scout.sarifThis ensures that security vulnerabilities are identified and fixed promptly, providing you with a more secure image.