diff --git a/docs/index.html b/docs/index.html
index 04f13a6..ec40f21 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -154,6 +154,10 @@
             <h2>Quick Start</h2>
             <p class="section-subtitle">Get up and running in minutes</p>
 
+            <div class="platform-note">
+                <p><strong>Supported Platforms:</strong> Officially tested on Debian and Ubuntu. Partial support for macOS. Other distributions have not been fully tested.</p>
+            </div>
+
             <div class="install-options">
                 <div class="install-card">
                     <h3>Standard Installation</h3>
diff --git a/docs/style.css b/docs/style.css
index a6db1c1..298e9d6 100644
--- a/docs/style.css
+++ b/docs/style.css
@@ -421,6 +421,25 @@ section h2 {
     color: var(--text-muted);
 }
 
+.platform-note {
+    background: var(--bg-card);
+    border: 1px solid var(--border);
+    border-left: 3px solid var(--accent);
+    border-radius: 8px;
+    padding: 16px 20px;
+    margin-bottom: 32px;
+}
+
+.platform-note p {
+    font-size: 0.9rem;
+    color: var(--text-secondary);
+    margin: 0;
+}
+
+.platform-note strong {
+    color: var(--text-primary);
+}
+
 .post-install {
     text-align: center;
     padding: 32px;