OpenWebUI Configuration Guide

This guide explains how to configure OpenWebUI to use your AI service as its backend.

Overview

Your AI service now implements the necessary API endpoints to be compatible with OpenWebUI. This allows OpenWebUI to use your AI service as its backend instead of connecting directly to Ollama.

Configuration Steps

1. Update OpenWebUI Environment Variables

You need to modify the OpenWebUI environment variables to point to your AI service. This can be done by editing the .env file in the OpenWebUI installation directory or by setting environment variables when running the OpenWebUI container.

Add or modify the following environment variables:

OLLAMA_API_BASE_URL=http://your-server-ip:5251/ollama
OPENAI_API_BASE_URL=http://your-server-ip:5251/api

Replace your-server-ip with the IP address or hostname of the server where your AI service is running.

2. Restart OpenWebUI

After updating the environment variables, restart the OpenWebUI service to apply the changes.

If you're running OpenWebUI using Docker:

docker restart openwebui

If you're running OpenWebUI directly:

# Stop the current process
pkill -f "openwebui"

# Start OpenWebUI again
cd /path/to/openwebui
npm start

Testing the Integration

To test if the integration is working correctly:

Open OpenWebUI in your browser (http://104.225.217.215:8080)
Try to create a new chat
Select one of the models (gemma3, llama3.3, llama3.1, mistral, or deepseek)
Send a message and check if you get a response

If everything is configured correctly, OpenWebUI will send requests to your AI service, which will then forward them to the Ollama API.

Troubleshooting

If you encounter issues with the integration:

Check the logs of your AI service:
```
tail -f logs/ai_service.log
```
Check the logs of OpenWebUI:
```
docker logs openwebui
```
Verify that your AI service is running and accessible:
```
curl http://your-server-ip:5251/health
```
Verify that the OpenWebUI environment variables are set correctly:
```
docker exec openwebui env | grep URL
```

Advanced Configuration

For advanced configuration options, refer to the OpenWebUI documentation: https://docs.openwebui.com/getting-started/env-configuration

2.3 KiB Raw Blame History