NanoGPT + Open WebUI Setup: Self-Hosted AI Interface
Open WebUI gives you a ChatGPT-like interface that runs on your own machine. pair it with NanoGPT and you get 400+ models without giving anyone your data.
TL;DR: install Open WebUI with Docker, add your NanoGPT API key, pick models. 10-minute setup, works on Mac, Linux, and Windows.
👉 Get NanoGPT with 5% discount — you'll need an API key for this setup.
Why Open WebUI?
Open WebUI (formerly Ollama WebUI) is the most popular open-source AI chat interface. it's clean, fast, and actively maintained.
Open WebUI vs Alternatives
| Feature | Open WebUI | LibreChat | ChatGPT | NanoGPT Web |
|---|---|---|---|---|
| Self-hosted | Yes | Yes | No | No |
| Open-source | Yes | Yes | No | No |
| Multi-model | Yes | Yes | Limited | Yes |
| Mobile UI | Excellent | Good | Good | Basic |
| RAG support | Yes | Yes | Yes | No |
| Image gen | Yes | Yes | Yes | No |
| User management | Yes | Yes | N/A | No |
| Setup difficulty | Easy | Medium | None | None |
Open WebUI is easier to set up than LibreChat and has a more polished mobile experience. LibreChat has more plugins and customization. pick based on your priorities.
Prerequisites
you need:
- NanoGPT account with API key (sign up here)
- Docker Desktop installed (or Docker Engine on Linux)
- 5-10 minutes
Install Docker
Mac/Windows: download Docker Desktop
Linux (Ubuntu/Debian):
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# log out and back in
Installation Methods
Method 1: Docker Run (Simplest)
docker run -d -p 3000:8080 \
--add-host=host.docker.internal:host-gateway \
-v open-webui:/app/backend/data \
--name open-webui \
--restart always \
ghcr.io/open-webui/open-webui:main
Method 2: Docker Compose (Recommended)
create a file called docker-compose.yml:
version: '3.8'
services:
open-webui:
image: ghcr.io/open-webui/open-webui:main
ports:
- "3000:8080"
volumes:
- open-webui:/app/backend/data
environment:
- WEBUI_AUTH=true
restart: always
volumes:
open-webui:
then run:
docker compose up -d
Access Open WebUI
open your browser and go to:
http://localhost:3000
create your admin account on first visit.
Connecting NanoGPT
Step 1: Open Settings
click your profile icon (bottom left) → Settings → Connections
Step 2: Add OpenAI API Connection
under OpenAI API, click the + button and fill in:
- API Base URL:
https://api.nano-gpt.com/v1 - API Key: your NanoGPT API key
click Save.
Step 3: Verify Connection
go back to the chat interface. in the model dropdown, you should see NanoGPT models listed. if you see models like gpt-4o, claude-3-5-sonnet, etc., you're connected.
Step 4: Select a Model
pick a model from the dropdown and send a test message:
Hello! Can you confirm which model you are?
if you get a response, setup is complete.
Model Configuration
Adding Custom Models
if models don't appear automatically:
- go to Settings → Models
- click Add Model
- enter:
- Model ID: e.g.,
gpt-4o - Base URL:
https://api.nano-gpt.com/v1 - API Key: your NanoGPT key
- Model ID: e.g.,
- save
Recommended Model Setup
| Model Name | Use Case | Settings |
|---|---|---|
| GPT-4o | General, code | Default |
| Claude 3.5 Sonnet | Writing, analysis | Default |
| GPT-4o-mini | Quick questions | Default |
| DeepSeek V3 | Budget coding | Default |
| Gemini 1.5 Pro | Long documents | Default |
see our model recommendations for the full list.
Model Presets
Open WebUI supports model presets. create presets for different tasks:
- start a new chat
- select your model
- click the gear icon next to the model
- set:
- Temperature: 0.7 (balanced) or 0.3 (focused)
- Max tokens: 2048 (or as needed)
- System prompt: your preferred default
- save as preset
Advanced Features
RAG (Retrieval-Augmented Generation)
Open WebUI supports document upload and RAG:
- click the + button in chat
- upload a PDF, text file, or document
- ask questions about the document
- the model uses the document as context
this works with any NanoGPT model that supports long contexts (Gemini 1.5 Pro is best for this).
Web Search
Open WebUI can search the web and include results in the AI's context:
- go to Settings → Web Search
- enable web search
- configure search provider (SearXNG, Google, etc.)
- the AI can now search and cite sources
Multi-User Setup
for sharing with others:
- go to Settings → Admin → Users
- enable user registration (or invite manually)
- each user gets their own conversation history
- all users share the NanoGPT API key
Troubleshooting
Common Issues
| Problem | Cause | Fix |
|---|---|---|
| No models showing | API connection not configured | Check Settings → Connections |
| "Invalid API key" | Wrong key or URL | Verify key at NanoGPT dashboard |
| Slow responses | Model or network | Try a faster model (GPT-4o-mini) |
| Docker won't start | Port conflict | Change port: -p 3001:8080 |
| Can't access from phone | Firewall | Open port 3000 in firewall |
| Blank page | Browser cache | Hard refresh (Ctrl+Shift+R) |
Docker Commands
# check status
docker ps
# view logs
docker logs open-webui
# restart
docker restart open-webui
# update to latest version
docker pull ghcr.io/open-webui/open-webui:main
docker stop open-webui
docker rm open-webui
# re-run the original docker run command
# or with compose
docker compose pull
docker compose up -d
API Connection Test
test your NanoGPT key outside Open WebUI:
curl https://api.nano-gpt.com/v1/models \
-H "Authorization: Bearer your-api-key"
if this returns model data, the issue is in Open WebUI configuration. if it errors, the issue is with your NanoGPT account or key.
see our API key setup guide for more troubleshooting.
Open WebUI vs LibreChat
i've used both extensively. here's my take:
| Aspect | Open WebUI | LibreChat | Winner |
|---|---|---|---|
| Setup ease | Easier | Harder | Open WebUI |
| UI polish | Better | Good | Open WebUI |
| Mobile experience | Excellent | Decent | Open WebUI |
| Plugin ecosystem | Growing | Larger | LibreChat |
| Customization | Good | Excellent | LibreChat |
| Multi-user | Good | Better | LibreChat |
| Documentation | Good | Better | LibreChat |
| Update frequency | Weekly | Weekly | Tie |
my pick: Open WebUI for personal use. LibreChat for teams or if you need heavy customization.
see our LibreChat setup guide for the alternative.
Open WebUI + NanoGPT FAQ
Is Open WebUI free?
yes. completely free and open-source. you only pay for AI usage through NanoGPT.
Can I run Open WebUI on a Raspberry Pi?
yes. it runs fine on a Raspberry Pi 4 or 5 with 4GB+ RAM. the UI is lightweight — the heavy lifting happens on NanoGPT's servers.
Does Open WebUI work on Windows?
yes. install Docker Desktop for Windows, then follow the same Docker commands. works on Windows 10/11 with WSL2.
Can I access Open WebUI from my phone?
yes. if it's running on your local network, access it via your computer's IP address: http://192.168.x.x:3000. for remote access, set up a VPN or reverse proxy.
How do I update Open WebUI?
docker pull ghcr.io/open-webui/open-webui:main
docker stop open-webui
docker rm open-webui
# re-run the docker run command
or with Docker Compose:
docker compose pull
docker compose up -d
Is my data private?
yes. Open WebUI runs locally. your conversations are stored on your machine. the only external connection is to NanoGPT's API when you send a message.
My Setup Experience
i've been running Open WebUI + NanoGPT for two months on a mini PC (Intel N100, 16GB RAM). it's my daily driver for AI chat.
pros: fast UI, great mobile experience, easy model switching, my data stays local.
cons: occasional Docker issues after updates, RAG setup requires extra configuration.
total cost: $6-8/month for NanoGPT credits. compared to $20/month for ChatGPT Plus with worse privacy, it's a clear win.
👉 Start with NanoGPT
Last updated: July 2026
Related Articles
- NanoGPT + LibreChat Setup — alternative interface
- NanoGPT API Key Setup — get your key first
- Best NanoGPT Models — full model list
- NanoGPT Pricing — cost breakdown
- NanoGPT Privacy Review — data handling
- SillyTavern + NanoGPT — for roleplay users
Disclosure: This article contains affiliate links. If you sign up through our referral link, you get a 5% discount and we earn a small commission. This doesn't affect our reviews — we pay for all services ourselves.