update docs

self-host/advanced/config-file.mdx

@@ -91,6 +91,18 @@ This section contains the complete reference for all configuration options in `c
 
       **Default**: `false`
     </ResponseField>
+
+    <ResponseField name="telemetry" type="object">
+      Telemetry configuration settings.
+
+      <Expandable title="Telemetry">
+        <ResponseField name="anonymous_usage" type="boolean">
+          Whether to enable anonymous usage telemetry.
+
+          **Default**: `true`
+        </ResponseField>
+      </Expandable>
+    </ResponseField>
   </Expandable>
 </ResponseField>
 

self-host/telemetry.mdx

@@ -0,0 +1,42 @@
+---
+title: "Telemetry"
+description: "Understanding Pangolin's anonymous usage data collection"
+---
+
+Pangolin collects anonymous usage telemetry to help us understand how the software is used and guide future improvements and feature development.
+
+## What We Collect
+
+The telemetry system collects **anonymous, aggregated data** about your Pangolin deployment. For example:
+
+- **System metrics**: Number of sites, users, resources, and clients
+- **Usage patterns**: Resource types, protocols, and SSO configurations
+- **Performance data**: Site traffic volumes and online status
+- **Deployment info**: App version and installation timestamp
+
+## Privacy & Anonymity
+
+**No personal information is ever collected or transmitted.** All data is:
+
+- **Anonymized**: Identifying info is hashed using SHA-256
+- **Non-identifying**: Cannot be used to identify specific users or organizations
+
+## Configuration
+
+You can control telemetry collection in your `config.yml`:
+
+```yaml
+app:
+  telemetry:
+    anonymous_usage: true  # Set to false to disable
+```
+
+## What This Helps
+
+Anonymous usage data helps us:
+- Identify popular features and usage patterns
+- Prioritize development efforts
+- Improve performance and reliability
+- Make Pangolin better for everyone
+
+If you have concerns about telemetry collection, you can disable it entirely by setting `anonymous_usage: false` in your configuration.