From 7e0b73deaa6083de3cb07928236611d82133b2ef Mon Sep 17 00:00:00 2001
From: Ettore Di Giacinto <mudler@localai.io>
Date: Fri, 3 Apr 2026 09:46:06 +0200
Subject: [PATCH] fix(docs): fix broken references to distributed mode

Signed-off-by: Ettore Di Giacinto <mudler@localai.io>
---
 docs/content/features/GPU-acceleration.md        | 2 +-
 docs/content/features/_index.en.md               | 3 +--
 docs/content/features/agents.md                  | 2 +-
 docs/content/features/audio-to-text.md           | 2 +-
 docs/content/features/authentication.md          | 2 +-
 docs/content/features/backends.md                | 2 +-
 docs/content/features/constrained_grammars.md    | 2 +-
 docs/content/features/distributed-mode.md        | 2 +-
 docs/content/features/distributed_inferencing.md | 4 ++--
 docs/content/features/embeddings.md              | 2 +-
 docs/content/features/gpt-vision.md              | 2 +-
 docs/content/features/image-generation.md        | 2 +-
 docs/content/features/mcp.md                     | 2 +-
 docs/content/features/model-gallery.md           | 2 +-
 docs/content/features/object-detection.md        | 2 +-
 docs/content/features/openai-functions.md        | 2 +-
 docs/content/features/reranker.md                | 2 +-
 docs/content/features/runtime-settings.md        | 2 +-
 docs/content/features/stores.md                  | 2 +-
 docs/content/features/text-generation.md         | 2 +-
 docs/content/features/text-to-audio.md           | 2 +-
 docs/content/getting-started/quickstart.md       | 2 +-
 22 files changed, 23 insertions(+), 24 deletions(-)

diff --git a/docs/content/features/GPU-acceleration.md b/docs/content/features/GPU-acceleration.md
index ef5ec5328..aedc47516 100644
--- a/docs/content/features/GPU-acceleration.md
+++ b/docs/content/features/GPU-acceleration.md
@@ -1,6 +1,6 @@
 +++
 disableToc = false
-title = "⚡ GPU acceleration"
+title = "GPU Acceleration"
 weight = 9
 url = "/features/gpu-acceleration/"
 +++
diff --git a/docs/content/features/_index.en.md b/docs/content/features/_index.en.md
index 0d07f2faf..5cae35820 100644
--- a/docs/content/features/_index.en.md
+++ b/docs/content/features/_index.en.md
@@ -27,8 +27,7 @@ LocalAI provides a comprehensive set of features for running AI models locally.
 - **[Realtime API](openai-realtime/)** - Low-latency multi-modal conversations (voice+text) over WebSocket
 - **[Constrained Grammars](constrained_grammars/)** - Control model output format with BNF grammars
 - **[GPU Acceleration](GPU-acceleration/)** - Optimize performance with GPU support
-- **[Distributed Inference](distributed_inferencing/)** - Scale inference across multiple nodes
-- **[Distributed Mode](distributed-mode/)** - Horizontal scaling with PostgreSQL, NATS, and remote backend nodes
+- **[Distribution](distribution/)** - Scale inference across multiple nodes (P2P federation or production distributed mode)
 - **[P2P API](p2p/)** - Monitor and manage P2P worker and federated nodes
 - **[Model Context Protocol (MCP)](mcp/)** - Enable agentic capabilities with MCP integration
 - **[Agents](agents/)** - Autonomous AI agents with tools, knowledge base, and skills
diff --git a/docs/content/features/agents.md b/docs/content/features/agents.md
index 0cfa231fe..b2eee5093 100644
--- a/docs/content/features/agents.md
+++ b/docs/content/features/agents.md
@@ -1,6 +1,6 @@
 +++
 disableToc = false
-title = "🤖 Agents"
+title = "Agents"
 weight = 21
 url = '/features/agents'
 +++
diff --git a/docs/content/features/audio-to-text.md b/docs/content/features/audio-to-text.md
index 88ce030a7..0ab9b9b6d 100644
--- a/docs/content/features/audio-to-text.md
+++ b/docs/content/features/audio-to-text.md
@@ -1,6 +1,6 @@
 +++
 disableToc = false
-title = "🔈 Audio to text"
+title = "Audio to Text"
 weight = 16
 url = "/features/audio-to-text/"
 +++
diff --git a/docs/content/features/authentication.md b/docs/content/features/authentication.md
index 1f9743365..6c0d50637 100644
--- a/docs/content/features/authentication.md
+++ b/docs/content/features/authentication.md
@@ -1,6 +1,6 @@
 +++
 disableToc = false
-title = "🔐 Authentication & Authorization"
+title = "Authentication & Authorization"
 weight = 26
 url = '/features/authentication'
 +++
diff --git a/docs/content/features/backends.md b/docs/content/features/backends.md
index a63461e7a..80b30bc33 100644
--- a/docs/content/features/backends.md
+++ b/docs/content/features/backends.md
@@ -1,5 +1,5 @@
 ---
-title: "⚙️ Backends"
+title: "Backends"
 description: "Learn how to use, manage, and develop backends in LocalAI"
 weight: 4
 url: "/backends/"
diff --git a/docs/content/features/constrained_grammars.md b/docs/content/features/constrained_grammars.md
index 33d50c900..5cf39c438 100644
--- a/docs/content/features/constrained_grammars.md
+++ b/docs/content/features/constrained_grammars.md
@@ -1,6 +1,6 @@
 +++
 disableToc = false
-title = "✍️ Constrained Grammars"
+title = "Constrained Grammars"
 weight = 15
 url = "/features/constrained_grammars/"
 +++
diff --git a/docs/content/features/distributed-mode.md b/docs/content/features/distributed-mode.md
index b942c244b..79dad2605 100644
--- a/docs/content/features/distributed-mode.md
+++ b/docs/content/features/distributed-mode.md
@@ -5,7 +5,7 @@ weight = 14
 url = "/features/distributed-mode/"
 +++
 
-Distributed mode enables horizontal scaling of LocalAI across multiple machines using **PostgreSQL** for state and node registry, and **NATS** for real-time coordination. Unlike the [P2P/federation approach](/features/distribute/), distributed mode is designed for production deployments and Kubernetes environments where you need centralized management, health monitoring, and deterministic routing.
+Distributed mode enables horizontal scaling of LocalAI across multiple machines using **PostgreSQL** for state and node registry, and **NATS** for real-time coordination. Unlike the [P2P/federation approach]({{% relref "features/distributed_inferencing" %}}), distributed mode is designed for production deployments and Kubernetes environments where you need centralized management, health monitoring, and deterministic routing.
 
 {{% notice note %}}
 Distributed mode requires authentication enabled with a **PostgreSQL** database — SQLite is not supported. This is because the node registry, job store, and other distributed state are stored in PostgreSQL tables.
diff --git a/docs/content/features/distributed_inferencing.md b/docs/content/features/distributed_inferencing.md
index 3877d90aa..3df597822 100644
--- a/docs/content/features/distributed_inferencing.md
+++ b/docs/content/features/distributed_inferencing.md
@@ -1,12 +1,12 @@
 +++
 disableToc = false
-title = "🆕🖧 Distributed Inference"
+title = "P2P / Federated Inference"
 weight = 15
 url = "/features/distribute/"
 +++
 
 {{% notice tip %}}
-Looking for production-grade horizontal scaling with PostgreSQL and NATS? See [Distributed Mode](/features/distributed-mode/).
+Looking for production-grade horizontal scaling with PostgreSQL and NATS? See [Distributed Mode]({{% relref "features/distributed-mode" %}}).
 {{% /notice %}}
 
 This functionality enables LocalAI to distribute inference requests across multiple worker nodes, improving efficiency and performance. Nodes are automatically discovered and connect via p2p by using a shared token which makes sure the communication is secure and private between the nodes of the network.
diff --git a/docs/content/features/embeddings.md b/docs/content/features/embeddings.md
index c6ee1ee31..fe7bc6693 100644
--- a/docs/content/features/embeddings.md
+++ b/docs/content/features/embeddings.md
@@ -1,6 +1,6 @@
 +++
 disableToc = false
-title = "🧠 Embeddings"
+title = "Embeddings"
 weight = 13
 url = "/features/embeddings/"
 +++
diff --git a/docs/content/features/gpt-vision.md b/docs/content/features/gpt-vision.md
index 79dcd8046..94410c64d 100644
--- a/docs/content/features/gpt-vision.md
+++ b/docs/content/features/gpt-vision.md
@@ -1,7 +1,7 @@
 
 +++
 disableToc = false
-title = "🥽 GPT Vision"
+title = "GPT Vision"
 weight = 14
 url = "/features/gpt-vision/"
 +++
diff --git a/docs/content/features/image-generation.md b/docs/content/features/image-generation.md
index a566bcb4a..e35b7fbf0 100644
--- a/docs/content/features/image-generation.md
+++ b/docs/content/features/image-generation.md
@@ -1,7 +1,7 @@
 
 +++
 disableToc = false
-title = "🎨 Image generation"
+title = "Image Generation"
 weight = 12
 url = "/features/image-generation/"
 +++
diff --git a/docs/content/features/mcp.md b/docs/content/features/mcp.md
index 1206a5d66..55f3226e3 100644
--- a/docs/content/features/mcp.md
+++ b/docs/content/features/mcp.md
@@ -1,5 +1,5 @@
 +++
-title = "🔗 Model Context Protocol (MCP)"
+title = "Model Context Protocol (MCP)"
 weight = 20
 toc = true
 description = "Agentic capabilities with Model Context Protocol integration"
diff --git a/docs/content/features/model-gallery.md b/docs/content/features/model-gallery.md
index a43ff2941..dc7d09493 100644
--- a/docs/content/features/model-gallery.md
+++ b/docs/content/features/model-gallery.md
@@ -1,7 +1,7 @@
 
 +++
 disableToc = false
-title = "🖼️ Model gallery"
+title = "Model Gallery"
 weight = 18
 url = '/models'
 +++
diff --git a/docs/content/features/object-detection.md b/docs/content/features/object-detection.md
index 8a1243240..43e8e7584 100644
--- a/docs/content/features/object-detection.md
+++ b/docs/content/features/object-detection.md
@@ -1,6 +1,6 @@
 +++
 disableToc = false
-title = "🔍 Object detection"
+title = "Object Detection"
 weight = 13
 url = "/features/object-detection/"
 +++
diff --git a/docs/content/features/openai-functions.md b/docs/content/features/openai-functions.md
index e77b00b3d..f1cdfc940 100644
--- a/docs/content/features/openai-functions.md
+++ b/docs/content/features/openai-functions.md
@@ -1,7 +1,7 @@
 
 +++
 disableToc = false
-title = "🔥 OpenAI functions and tools"
+title = "OpenAI Functions and Tools"
 weight = 17
 url = "/features/openai-functions/"
 +++
diff --git a/docs/content/features/reranker.md b/docs/content/features/reranker.md
index b17859475..bf830d768 100644
--- a/docs/content/features/reranker.md
+++ b/docs/content/features/reranker.md
@@ -1,7 +1,7 @@
 
 +++
 disableToc = false
-title = "📈 Reranker"
+title = "Reranker"
 weight = 11
 url = "/features/reranker/"
 +++
diff --git a/docs/content/features/runtime-settings.md b/docs/content/features/runtime-settings.md
index 1110f1cf7..538e4b9b6 100644
--- a/docs/content/features/runtime-settings.md
+++ b/docs/content/features/runtime-settings.md
@@ -1,6 +1,6 @@
 +++
 disableToc = false
-title = "⚙️ Runtime Settings"
+title = "Runtime Settings"
 weight = 25
 url = '/features/runtime-settings'
 +++
diff --git a/docs/content/features/stores.md b/docs/content/features/stores.md
index f17490d38..c9558db9a 100644
--- a/docs/content/features/stores.md
+++ b/docs/content/features/stores.md
@@ -1,7 +1,7 @@
 
 +++
 disableToc = false
-title = "💾 Stores"
+title = "Stores"
 weight = 18
 url = '/stores'
 +++
diff --git a/docs/content/features/text-generation.md b/docs/content/features/text-generation.md
index 00f2a3156..aa8608ec3 100644
--- a/docs/content/features/text-generation.md
+++ b/docs/content/features/text-generation.md
@@ -1,7 +1,7 @@
 
 +++
 disableToc = false
-title = "📖 Text generation (GPT)"
+title = "Text Generation (GPT)"
 weight = 10
 url = "/features/text-generation/"
 +++
diff --git a/docs/content/features/text-to-audio.md b/docs/content/features/text-to-audio.md
index 59081f164..62f745137 100644
--- a/docs/content/features/text-to-audio.md
+++ b/docs/content/features/text-to-audio.md
@@ -1,7 +1,7 @@
 
 +++
 disableToc = false
-title = "🗣 Text to audio (TTS)"
+title = "Text to Audio (TTS)"
 weight = 11
 url = "/features/text-to-audio/"
 +++
diff --git a/docs/content/getting-started/quickstart.md b/docs/content/getting-started/quickstart.md
index 10a220e5b..5dad07ca3 100644
--- a/docs/content/getting-started/quickstart.md
+++ b/docs/content/getting-started/quickstart.md
@@ -119,7 +119,7 @@ For production deployments or when you need more compute, LocalAI supports distr
 - **P2P federation**: Connect multiple LocalAI instances for load-balanced inference
 - **Model sharding**: Split large models across multiple machines
 
-See the **Nodes** page in the web interface or the [Distribution docs]({{% relref "features/distribute" %}}) for setup instructions.
+See the **Nodes** page in the web interface or the [Distribution docs]({{% relref "features/distribution" %}}) for setup instructions.
 
 ## What's Next?