From 7d0ec543b7398ce5cf54fb3eb8d441ee8136a1e5 Mon Sep 17 00:00:00 2001
From: "Timothy J. Baek" <timothyjrbeck@gmail.com>
Date: Tue, 24 Oct 2023 18:12:00 -0700
Subject: [PATCH] doc: troubleshooting guide added

---
 README.md                                    | 28 ++++++++++++++++++++
 src/lib/components/chat/SettingsModal.svelte |  5 +++-
 2 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8e7ac2356..a4ad977dc 100644
--- a/README.md
+++ b/README.md
@@ -117,6 +117,34 @@ docker run -d -p 3000:8080 --name ollama-webui --restart always ollama-webui
    caddy run --envfile .env --config ./Caddyfile.localhost
    ```
 
+## Troubleshooting
+
+### Connection Errors
+
+If you encounter difficulties connecting to the Ollama server, please follow these steps to diagnose and resolve the issue:
+
+**1. Verify Ollama Server Configuration**
+
+Ensure that the Ollama server is properly configured to accept incoming connections from all origins. To do this, make sure the server is launched with the `OLLAMA_ORIGINS=*` environment variable, as shown in the following command:
+
+```bash
+OLLAMA_HOST=0.0.0.0 OLLAMA_ORIGINS=* ollama serve
+```
+
+This configuration allows Ollama to accept connections from any source.
+
+**2. Check Ollama URL Format**
+
+Ensure that the Ollama URL is correctly formatted in the application settings. Follow these steps:
+
+- Go to "Settings" within the Ollama WebUI.
+- Navigate to the "General" section.
+- Verify that the Ollama URL is in the following format: `http://localhost:11434/api`.
+
+It is crucial to include the `/api` at the end of the URL to ensure that the Ollama Web UI can communicate with the server.
+
+By following these troubleshooting steps, you should be able to identify and resolve connection issues with your Ollama server configuration. If you require further assistance or have additional questions, please don't hesitate to reach out or refer to our documentation for comprehensive guidance.
+
 ## What's Next? 🚀
 
 ### To-Do List 📝
diff --git a/src/lib/components/chat/SettingsModal.svelte b/src/lib/components/chat/SettingsModal.svelte
index 66e395250..42fd8c6fa 100644
--- a/src/lib/components/chat/SettingsModal.svelte
+++ b/src/lib/components/chat/SettingsModal.svelte
@@ -35,12 +35,15 @@
 	};
 
 	const checkOllamaConnection = async () => {
+		if (API_BASE_URL === '') {
+			API_BASE_URL = BUILD_TIME_API_BASE_URL;
+		}
 		const res = await getModelTags(API_BASE_URL);
 
 		if (res) {
 			toast.success('Server connection verified');
 			saveSettings(
-				API_BASE_URL === '' ? BUILD_TIME_API_BASE_URL : API_BASE_URL,
+				API_BASE_URL,
 				system != '' ? system : null,
 				temperature != 0.8 ? temperature : null
 			);