Merge branch 'main' of github.com:fosrl/docs-v2

docs.json

@@ -92,6 +92,7 @@
                                     "manage/clients/nat-traversal",
                                     "manage/clients/install-client",
                                     "manage/clients/configure-client",
+                                    "manage/clients/client-logs",
                                     "manage/clients/update-client",
                                     "manage/clients/credentials",
                                     "manage/clients/fingerprinting",

manage/clients/client-logs.mdx

@@ -0,0 +1,72 @@
+---
+title: "Client Logs"
+description: "View Pangolin client logs on Windows, Mac, Linux, Android, and iOS"
+---
+
+import PangolinCloudTocCta from "/snippets/pangolin-cloud-toc-cta.mdx";
+
+<PangolinCloudTocCta />
+
+
+
+How you access client logs depends on the platform. Use the section for your client type below.
+
+## Windows
+
+You can view logs in the Pangolin client GUI under **Preferences > Logs**.
+
+You can also open the log file directly. The default location is:
+
+```
+C:\ProgramData\pangolin\logs\pangolin.log
+```
+
+To tail the log in PowerShell:
+
+```powershell
+Get-Content "C:\ProgramData\pangolin\logs\pangolin.log" -Tail 0 -Wait
+```
+
+## Mac
+
+Mac uses the Apple system logger. To stream Pangolin logs:
+
+```bash
+log stream --predicate 'subsystem == "net.pangolin.Pangolin" OR subsystem == "net.pangolin.Pangolin.PacketTunnel"' --level debug --style compact
+```
+
+## CLI / Linux
+
+The default log file location is:
+
+```
+~/.config/pangolin/logs/client.log
+```
+
+If you run `pangolin up` in detached mode, you can tail logs with:
+
+```bash
+pangolin logs client -f -n 10
+```
+
+This example follows new log lines and shows the last 10 rows.
+
+Alternatively, run in attached mode to see logs in the current terminal session:
+
+```bash
+sudo pangolin up --attach
+```
+
+## Android
+
+View logs within the app under **Preferences > Logs**.
+
+## iOS
+
+Because of how iOS handles system logging, attach the iPhone to a Mac and use Console.app to view logs.
+
+In Console.app, add a **Subsystem** filter for:
+
+```
+net.pangolin.Pangolin
+```

manage/clients/configure-client.mdx

@@ -13,6 +13,8 @@ import PangolinCloudTocCta from "/snippets/pangolin-cloud-toc-cta.mdx";
 
 Each respective client has a preferences window with all currently available configuration parameters. In your desktop client, click the menu bar or system tray icon, select "More" in the menu, and click "Preferences". In the mobile apps, navigate to the "Settings" screen.
 
+To troubleshoot connection or configuration issues, see [Client Logs](/manage/clients/client-logs) for how to view logs on each platform.
+
 ## Preferences
 
 The following preferences control how your client handles DNS resolution and network routing. Understanding these settings helps you configure Pangolin to work best with your network setup.

snippets/pangolin-cloud-toc-cta.mdx

@@ -1,4 +1,4 @@
-<div id="pangolin-toc-cta" className="pangolin-toc-cta-source">
+{/* <div id="pangolin-toc-cta" className="pangolin-toc-cta-source">
   <Card
     title="Try free on Pangolin Cloud"
     icon="cloud"
@@ -8,4 +8,5 @@
   >
     Fastest way to get started with Pangolin using the hosted control plane. No credit card required.
   </Card>
-</div>
+</div> */}
+<div></div>

style.css

@@ -167,15 +167,15 @@
   }
   
   /* Hide the Pangolin Cloud CTA source wrapper so it doesn't show in main content before the script moves it to the TOC */
-  .pangolin-toc-cta-source {
+  /* .pangolin-toc-cta-source {
     display: none !important;
-  }
+  } */
   
   /* Space above the Pangolin Cloud CTA (below the table of contents links) */
-  #table-of-contents > *:last-child {
+  /* #table-of-contents > *:last-child {
     margin-top: 1.25rem;
     background-color: #F2F0E7;
-  }
+  } */
   
   #navbar .max-w-8xl {
     max-width: 100%;