[PR #1379] docs: backups page says what cache/ is, and gains a Restoring section #1346

New issue

Open

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

bsakaguchi commented

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

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1379
Author: @spelingbee
Created: 9/4/2026
Status: 🔄 Open

Base: main ← Head: docs-backups-cache-and-restoring

📝 Commits (1)

cc67930 docs: backups page says what cache/ is, and gains a Restoring section

📊 Changes

1 file changed (+17 additions, -1 deletions)

View changed files

📝 docs/tutorials/maintenance/backups.md (+17 -1)

📄 Description

Summary

Two additions to the backups page. The files table now says what cache/ is (downloaded embedding and speech models, re-downloaded on demand, safe to exclude, and why two of the three example scripts exclude it: on a fresh instance it was 1.1 GB against about a megabyte of user data, and it contains symlinks). And a short Restoring section, since the page covers taking a backup and stops there: stop the stack, put the data directory back, start it, and make sure webui.db-wal / webui.db-shm travel with webui.db if files were copied individually.

#1378

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

Measured on v0.11.1 with the default SQLite setup, one account and one chat: du of the data directory was 1.1G, of which cache/ was 1.1G, webui.db 632K, webui.db-wal 160K, vector_db 184K. The restore sequence was tested by restoring the directory into a fresh stack, with and without cache/.

Closes #1378.

_{🔄 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/1379 **Author:** [@spelingbee](https://github.com/spelingbee) **Created:** 9/4/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs-backups-cache-and-restoring` --- ### 📝 Commits (1) - [`cc67930`](https://github.com/open-webui/docs/commit/cc679305ce2f95d542605df259f8b9ea73923538) docs: backups page says what cache/ is, and gains a Restoring section ### 📊 Changes **1 file changed** (+17 additions, -1 deletions) <details> <summary>View changed files</summary> 📝 `docs/tutorials/maintenance/backups.md` (+17 -1) </details> ### 📄 Description ## Summary Two additions to the backups page. The files table now says what `cache/` is (downloaded embedding and speech models, re-downloaded on demand, safe to exclude, and why two of the three example scripts exclude it: on a fresh instance it was 1.1 GB against about a megabyte of user data, and it contains symlinks). And a short Restoring section, since the page covers taking a backup and stops there: stop the stack, put the data directory back, start it, and make sure `webui.db-wal` / `webui.db-shm` travel with `webui.db` if files were copied individually. ## Related issue or discussion #1378 ## 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 Measured on v0.11.1 with the default SQLite setup, one account and one chat: `du` of the data directory was 1.1G, of which `cache/` was 1.1G, `webui.db` 632K, `webui.db-wal` 160K, `vector_db` 184K. The restore sequence was tested by restoring the directory into a fresh stack, with and without `cache/`. Closes #1378. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi added the

pull-request

label

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