diff --git a/website/docs/api.html b/website/docs/api.html
index d8383135..fc732802 100644
--- a/website/docs/api.html
+++ b/website/docs/api.html
@@ -180,13 +180,19 @@
                 
                 <p>For development:</p>
                 <pre class="code-inline"><code>http://localhost:8000</code></pre>
+                <p style="font-size: 0.85rem; color: #64748b; margin-top: 0.5rem;">
+                    <strong>Note:</strong> Legacy port 18000 has been replaced with port 8000
+                </p>
             </section>
 
             <!-- WebSocket -->
             <section class="content-section">
                 <h2>WebSocket API</h2>
                 <p>Real-time updates are available through WebSocket connections:</p>
-                <pre class="code-inline"><code>ws://aitbc.bubuit.net:18001/ws</code></pre>
+                <pre class="code-inline"><code>ws://aitbc.bubuit.net:8015/ws</code></pre>
+                <p style="font-size: 0.85rem; color: #64748b; margin-top: 0.5rem;">
+                    <strong>Note:</strong> Legacy WebSocket port 18001 has been replaced with port 8015
+                </p>
                 
                 <p>Subscribe to events:</p>
                 <pre class="code-inline"><code>{
diff --git a/website/docs/flowchart.html b/website/docs/flowchart.html
index 80cae4e5..b400870c 100644
--- a/website/docs/flowchart.html
+++ b/website/docs/flowchart.html
@@ -55,6 +55,9 @@
                     </div>
                     <div style="font-size: 0.85rem; color: #64748b; text-align: center; margin-top: 1rem;">
                         <div>(aitbc-cli.sh) → (client.py) → (port 8000) → (RPC:8006) → (port 8010) → (port 11434)</div>
+                        <div style="font-size: 0.75rem; color: #94a3b8; margin-top: 0.25rem;">
+                            Note: Legacy ports 18000/18001 have been replaced with 8000/8010
+                        </div>
                     </div>
                 </div>