From 41672c95597a8d80342466b764c68e760ae3003d Mon Sep 17 00:00:00 2001 From: "Timothy J. Baek" Date: Wed, 8 May 2024 09:37:34 -0700 Subject: [PATCH] refac --- docs/getting-started/index.md | 2 +- .../index.md} | 22 ++++++++++++------- 2 files changed, 15 insertions(+), 9 deletions(-) rename docs/{getting-started/troubleshooting.md => troubleshooting/index.md} (99%) diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md index 927f9f6..0df4d34 100644 --- a/docs/getting-started/index.md +++ b/docs/getting-started/index.md @@ -150,7 +150,7 @@ docker run -d --network=host -v open-webui:/app/backend/data -e OLLAMA_BASE_URL= For more details on networking in Docker and addressing common connectivity issues, visit our [FAQ page](/faq/). This page provides additional context and solutions for frequently encountered problems, ensuring a smoother operation of Open WebUI in various environments. -## One-line Command to Install Ollama and Open WebUI Together +## Docker Compose #### Using Docker Compose diff --git a/docs/getting-started/troubleshooting.md b/docs/troubleshooting/index.md similarity index 99% rename from docs/getting-started/troubleshooting.md rename to docs/troubleshooting/index.md index 5d12a9a..c372a71 100644 --- a/docs/getting-started/troubleshooting.md +++ b/docs/troubleshooting/index.md @@ -1,3 +1,8 @@ +--- +sidebar_position: 3 +title: "🛠️ Troubleshooting" +--- + # Troubleshooting ## Understanding the Open WebUI Architecture @@ -47,7 +52,7 @@ C4Context Component(ollama, "Ollama", "Listening on port 11434") } - + Rel(openwebui, ollama, "Makes API calls via Docker proxy", "http://host.docker.internal:11434") Rel(user, openwebui, "Makes requests via exposed port -p 3000:8080", "http://localhost:3000") UpdateRelStyle(user, openwebui, $offsetX="-100", $offsetY="-50") @@ -69,7 +74,7 @@ C4Context } } - + Rel(openwebui, ollama, "Makes API calls via inter-container networking", "http://ollama:11434") UpdateRelStyle(openwebui, ollama, $offsetX="-100", $offsetY="-50") Rel(user, openwebui, "Makes requests via exposed port -p 3000:8080", "http://localhost:3000") @@ -94,7 +99,7 @@ C4Context } } - + Rel(openwebui, ollama, "Unable to connect") Rel(user, openwebui, "Makes requests via exposed port -p 3000:8080", "http://localhost:3000") UpdateRelStyle(user, openwebui, $offsetX="-100", $offsetY="-50") @@ -113,7 +118,7 @@ C4Context } } - + Rel(user, openwebui, "Unable to connect, host network is the VM's network") UpdateRelStyle(user, openwebui, $offsetX="-100", $offsetY="-50") @@ -132,7 +137,7 @@ C4Context Component(ollama, "Ollama", "Listening on port 11434") } - + Rel(openwebui, ollama, "Makes API calls via Docker proxy", "http://host.docker.internal:11434") Rel(user, openwebui, "Makes requests via exposed port -p 3000:8080", "http://localhost:3000") UpdateRelStyle(user, openwebui, $offsetX="-100", $offsetY="-50") @@ -154,7 +159,7 @@ C4Context } } - + Rel(openwebui, ollama, "Makes API calls via inter-container networking", "http://ollama:11434") UpdateRelStyle(openwebui, ollama, $offsetX="-100", $offsetY="-50") Rel(user, openwebui, "Makes requests via exposed port -p 3000:8080", "http://localhost:3000") @@ -177,7 +182,7 @@ C4Context } } - + Rel(openwebui, ollama, "Unable to connect") Rel(user, openwebui, "Makes requests via exposed port -p 3000:8080", "http://localhost:3000") UpdateRelStyle(user, openwebui, $offsetX="-100", $offsetY="-50") @@ -201,7 +206,6 @@ C4Context ``` - ### General Connection Errors **Ensure Ollama Version is Up-to-Date**: Always start by checking that you have the latest version of Ollama. Visit [Ollama's official site](https://ollama.com/) for the latest updates. @@ -224,6 +228,7 @@ If you've forgotten your admin password, you can reset it by following these ste To reset the admin password for Open WebUI in a Docker deployment, generate a bcrypt hash of your new password and run a Docker command to update the database. Replace `your-new-password` with the desired password and execute: 1. **Generate bcrypt hash** (local machine): + ```bash htpasswd -bnBC 10 "" your-new-password | tr -d ':\n' ``` @@ -238,6 +243,7 @@ To reset the admin password for Open WebUI in a Docker deployment, generate a bc For local installations of Open WebUI, navigate to the `open-webui` directory and update the password in the `backend/data/webui.db` database. 1. **Generate bcrypt hash** (local machine): + ```bash htpasswd -bnBC 10 "" your-new-password | tr -d ':\n' ```