[PR #1448] [MERGED] docs: explain updating and deleting models on the Ollama page #1411

New issue

Closed

opened 2026-10-18 14:19:29 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 14:19:29 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1448
Author: @silentoplayz
Created: 10/1/2026
Status: ✅ Merged
Merged: 10/1/2026
Merged by: @silentoplayz

Base: main ← Head: docs/ollama-update-delete-models

📝 Commits (1)

a3bca1a docs: explain updating and deleting models on the Ollama page

📊 Changes

1 file changed (+21 additions, -0 deletions)

View changed files

📝 docs/getting-started/quick-start/connect-a-provider/starting-with-ollama.mdx (+21 -0)

📄 Description

Summary

The Ollama page covers downloading and unloading models, but not the other two things the Manage dialog does: Update All Models and Delete a model. This adds an "Updating and Deleting Models" section between downloading and unloading.

It covers:

that both act only on the Ollama server behind the connection whose Manage was opened
Update All Models: it re-pulls every model one at a time, shows progress with a Cancel button, skips a model that cannot be pulled, and ends with "All models are up to date"
that a model loaded before an update keeps the old version until it is unloaded, with a link to the unloading section
Delete a model: the steps, that it frees disk space and removes the model for every user of that connection, and the Model IDs (Filter) as the way to hide a model without deleting it

None. Model updating and deleting was listed as missing in https://github.com/open-webui/docs/issues/2#issuecomment-2321401452 ("Pull/Update/Delete Models").

Checklist

I have reviewed the relevant documentation and matched the existing style.
This PR meets Open WebUI's contribution standards: it is accurate, relevant to users, narrowly scoped, maintainable, and not promotional content, advertising, lead generation, SEO placement, or a request to list a product, service, provider, integration, gateway, tool, or company primarily for visibility.
I understand that PRs that do not meet these standards may be closed without review and will not be merged. Repeated, low-quality, off-topic, promotional, or intentionally misleading submissions may result in the contributor being blocked from future participation in Open WebUI repositories.

Notes for reviewers

Checked against dev at 015dbc8: updateModelsHandler, deleteModelHandler and the dialog markup in src/lib/components/admin/Settings/Models/Manage/ManageOllama.svelte, and delete_model in backend/open_webui/routers/ollama.py, which deletes on the connection index the dialog passes.

The page built and rendered with docusaurus start, and the new section's links to Step 2, Advanced Configuration and Unloading Loaded Models resolve.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/docs/pull/1448 **Author:** [@silentoplayz](https://github.com/silentoplayz) **Created:** 10/1/2026 **Status:** ✅ Merged **Merged:** 10/1/2026 **Merged by:** [@silentoplayz](https://github.com/silentoplayz) **Base:** `main` ← **Head:** `docs/ollama-update-delete-models` --- ### 📝 Commits (1) - [`a3bca1a`](https://github.com/open-webui/docs/commit/a3bca1a3c7f76b8122b1819d20e636da5f756f81) docs: explain updating and deleting models on the Ollama page ### 📊 Changes **1 file changed** (+21 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/getting-started/quick-start/connect-a-provider/starting-with-ollama.mdx` (+21 -0) </details> ### 📄 Description ## Summary The Ollama page covers downloading and unloading models, but not the other two things the **Manage** dialog does: **Update All Models** and **Delete a model**. This adds an "Updating and Deleting Models" section between downloading and unloading. It covers: - that both act only on the Ollama server behind the connection whose **Manage** was opened - **Update All Models**: it re-pulls every model one at a time, shows progress with a **Cancel** button, skips a model that cannot be pulled, and ends with "All models are up to date" - that a model loaded before an update keeps the old version until it is unloaded, with a link to the unloading section - **Delete a model**: the steps, that it frees disk space and removes the model for every user of that connection, and the **Model IDs (Filter)** as the way to hide a model without deleting it ## Related issue or discussion None. Model updating and deleting was listed as missing in https://github.com/open-webui/docs/issues/2#issuecomment-2321401452 ("Pull/Update/Delete Models"). ## Checklist - [x] I have reviewed the relevant documentation and matched the existing style. - [x] This PR meets Open WebUI's contribution standards: it is accurate, relevant to users, narrowly scoped, maintainable, and not promotional content, advertising, lead generation, SEO placement, or a request to list a product, service, provider, integration, gateway, tool, or company primarily for visibility. - [x] I understand that PRs that do not meet these standards may be closed without review and will not be merged. Repeated, low-quality, off-topic, promotional, or intentionally misleading submissions may result in the contributor being blocked from future participation in Open WebUI repositories. ## Notes for reviewers Checked against `dev` at 015dbc8: `updateModelsHandler`, `deleteModelHandler` and the dialog markup in `src/lib/components/admin/Settings/Models/Manage/ManageOllama.svelte`, and `delete_model` in `backend/open_webui/routers/ollama.py`, which deletes on the connection index the dialog passes. The page built and rendered with `docusaurus start`, and the new section's links to Step 2, Advanced Configuration and Unloading Loaded Models resolve. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:19:29 +00:00