diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index ca58edd8..cb9003a2 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -78,6 +78,7 @@ export default defineConfig({
           items: [
             { text: "Deployment & Docker", link: "/config/deployment" },
             { text: "Environment Variables", link: "/config/env" },
+            { text: "Storage Fine Tuning", link: "/config/storage-fine-tuning" },
             { text: "Authentication", link: "/config/authentication" },
             { text: "OIDC / SSO", link: "/config/oidc" },
             { text: "OIDC Config Examples", link: "/config/oidc-config-examples" },
diff --git a/docs/config/index.md b/docs/config/index.md
index 7a3c8c9d..35d424f2 100644
--- a/docs/config/index.md
+++ b/docs/config/index.md
@@ -6,6 +6,7 @@ OxiCloud is configured entirely via **environment variables** (no config files n
 
 - [Deployment & Docker](/config/deployment) — Docker Compose, Kubernetes Helm chart, image details
 - [Environment Variables](/config/env) — complete reference of all `OXICLOUD_*` variables
+- [Storage Fine Tuning](/config/storage-fine-tuning) — sizing the upload caps + spool directories; tmpfs vs real disk; NVMe split layouts
 - [Authentication](/config/authentication) — JWT auth, login, refresh, password changes, and auth status
 - [OIDC / SSO](/config/oidc) — single sign-on with Keycloak, Authentik, Authelia, Google, Azure AD
 - [WOPI (Office Editing)](/config/wopi) — Collabora Online / OnlyOffice integration