kylefoxaustin/openwebui Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

OpenWebUI with Ollama Docker Images

Docker images combining OpenWebUI with Ollama for a seamless AI development experience.

Available Images

• kylefoxaustin/openwebui-ollama:latest or kylefoxaustin/openwebui-ollama:latest-cpu - CPU version
• kylefoxaustin/openwebui-ollama:latest-gpu - GPU version with NVIDIA CUDA support

Quick Start

CPU Version

bash
docker run -d \
  --name openwebui \
  -p 8080:8080 \
  -p ***:*** \
  -v ollama-data:/root/.ollama \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest

GPU Version

bash
docker run -d \
  --name openwebui-gpu \
  --gpus all \
  -p 8080:8080 \
  -p ***:*** \
  -v ollama-data:/root/.ollama \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest-gpu

Access the web interface at: http://localhost:8080

Usage Scenarios

Coexisting with Local Ollama Installation

If you already have Ollama running on your host machine, you'll need to map the container's Ollama port to a different host port:

bash
docker run -d \
  --name openwebui \
  -p 8080:8080 \
  -p ***:*** \
  -v ollama-data:/root/.ollama \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest

Running CPU and GPU Containers Simultaneously

To run both CPU and GPU containers at the same time, use different port mappings:

bash
# CPU Container
docker run -d \
  --name openwebui-cpu \
  -p 8080:8080 \
  -p ***:*** \
  -v ollama-cpu-data:/root/.ollama \
  -v openwebui-cpu-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest-cpu

# GPU Container
docker run -d \
  --name openwebui-gpu \
  --gpus all \
  -p 8081:8080 \
  -p ***:*** \
  -v ollama-gpu-data:/root/.ollama \
  -v openwebui-gpu-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest-gpu

Access the interfaces at:

• CPU version: http://localhost:8080
• GPU version: http://localhost:8081

Using with External Ollama

To use OpenWebUI with an external Ollama instance (e.g., running on another server or container):

bash
docker run -d \
  --name openwebui-only \
  -p 8080:8080 \
  -e OLLAMA_BASE_URL=http://<ollama-host>:*** \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest

Replace <ollama-host> with the hostname or IP address of your Ollama server.

Environment Variables

Data Persistence

The following volumes are used for data persistence:

• /root/.ollama: Ollama models and configuration
• /app/backend/data: OpenWebUI data (conversations, settings, etc.)

Troubleshooting

Common Issues

1. Port Conflicts: If you see "address already in use" errors, you likely have another service using the same port. Use alternative ports as shown in the usage scenarios.

2. GPU not detected: Ensure your NVIDIA drivers are properly installed and the NVIDIA Container Toolkit is set up correctly. Test with:

   bash
   docker run --gpus all nvidia/cuda:11.8.0-base-ubuntu22.04 nvidia-smi
   

3. Container crashes: Check logs with:

   bash
   docker logs openwebui
   

4. Models not loading: The first time you pull a model might take some time. Check the Ollama logs:

   bash
   docker exec -it openwebui cat /var/log/supervisor/ollama.err.log
   

5. Web UI not accessible: Make sure that the internal Ollama instance is properly running:

   bash
   docker exec -it openwebui curl -s http://localhost:***/api/tags
   

Advanced Configuration

Docker Compose

For more complex setups, you can use Docker Compose. Here's an example configuration:

yaml
version: '3.8'

services:
  openwebui:
    image: kylefoxaustin/openwebui-ollama:latest-gpu
    container_name: openwebui
    restart: unless-stopped
    ports:
      - "8080:8080"
      - "***:***"
    volumes:
      - ollama-data:/root/.ollama
      - openwebui-data:/app/backend/data
    environment:
      - OLLAMA_HOST=0.0.0.0
      - PORT=8080
      - HOST=0.0.0.0
      - OLLAMA_BASE_URL=http://localhost:***
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]

volumes:
  ollama-data:
  openwebui-data:

Save this to docker-compose.yml and run with:

bash
docker-compose up -d

Resource Limits

To control CPU and memory usage:

bash
docker run -d \
  --name openwebui \
  --cpus 4 \
  --memory 8G \
  -p 8080:8080 \
  -p ***:*** \
  -v ollama-data:/root/.ollama \
  -v openwebui-data:/app/backend/data \
  kylefoxaustin/openwebui-ollama:latest

Building from Source

If you want to build the images yourself:

bash
# CPU image
docker build -f Dockerfile.cpu -t openwebui-ollama:cpu .

# GPU image
docker build -f Dockerfile.gpu -t openwebui-ollama:gpu .

License

These Docker images combine OpenWebUI and Ollama, each with their respective licenses. See the original projects for more information.

kylefoxaustin