Update ssh docs

Author: heisbrot

public/docs-static/img/ssh/ssh-client.png

@@ -58,6 +58,7 @@ export const docsNavigation = [
                  { title: 'Approve Peers', href: '/how-to/approve-peers' },
                  { title: 'Setup Keys', href: '/how-to/register-machines-using-setup-keys' },
                  { title: 'Browser Client', href: '/how-to/browser-client' },
+                 { title: 'SSH', href: '/how-to/ssh' },
                  { title: 'Lazy Connections', href: '/how-to/lazy-connection'},
                  {
                      title: 'Access Infrastructure',

public/docs-static/img/ssh/ssh-dashboard.png

@@ -59,7 +59,7 @@ When connecting via SSH:
 </p>
 
 <Note>
-    **NetBird SSH Required**: The target peer must have NetBird's SSH server enabled. Learn how to [enable SSH access](/how-to/cli#ssh).
+    **NetBird SSH Required**: The target peer must have NetBird's SSH server enabled. <br/> Learn how to [enable SSH access](/how-to/ssh).
 </Note>
 
 ### RDP Connection

src/components/NavigationDocs.jsx

@@ -394,7 +394,9 @@ Peers count: 2/3 Connected
 
 ### ssh
 Command to connect using ssh to a remote peer in your NetBird network.
-
+<Note>
+    Before using this command, make sure that SSH Access is enabled both on the target peer and in the NetBird Dashboard. Learn more about [enabling SSH access](/how-to/ssh).
+</Note>
 You should run the ssh command with elevated permissions.
 #### Flags
 ```shell
@@ -419,11 +421,14 @@ When you try to connect via `netbird ssh <peer>`, errors can occur. Please enabl
 ```shell
 netbird up --allow-server-ssh
 ```
-This will allow the the `SSH Access feature` to work when enabled in the dashboard, under Peers > _your_peer_ > SSH Access.
+
+Ensure that the peer you are trying to connect to has `SSH Access` enabled in the dashboard, under Peers > _your_peer_ > SSH Access.
+
 <p>
-    <img src="/docs-static/img/how-to-guides/enable-ssh-access.png" alt="high-level-dia" className="imagewrapper-big"/>
+    <img src="/docs-static/img/ssh/ssh-dashboard.png" alt="netbird ssh dashboard" className="imagewrapper-big" />
 </p>
 
+
 ### version
 Outputs the `netbird` command version.
 #### Usage

src/pages/how-to/browser-client.mdx

@@ -0,0 +1,62 @@
+import {Note} from "@/components/mdx";
+
+# SSH
+
+NetBird provides secure SSH access to your peers through its built-in SSH server, allowing you to connect to remote machines without exposing SSH ports to the internet.
+
+<Note>
+    SSH Access is disabled by default and must be enabled both on the target peer and in the NetBird Dashboard.
+</Note>
+
+
+## Requirements
+
+To use SSH access through NetBird, you need to enable SSH in two places:
+
+1. **NetBird Client Settings** - Enable SSH on the target peer
+2. **NetBird Dashboard** - Allow SSH access for the peer
+
+## Enabling SSH
+
+### Step 1: Enable SSH Server on Target Peer
+
+On the machine you want to access via SSH:
+
+1. Click on the NetBird tray icon
+2. Navigate Settings
+3. Click on **Allow SSH** to enable the SSH server
+
+<p>
+    <img src="/docs-static/img/ssh/ssh-client.png" alt="netbird ssh client" className="imagewrapper" />
+</p>
+
+### Step 2: Enable SSH in Dashboard
+
+1. Log in to your NetBird Dashboard
+2. Navigate to the target peer details page
+3. Enable SSH access for the peer
+4. Save the changes
+
+<p>
+    <img src="/docs-static/img/ssh/ssh-dashboard.png" alt="netbird ssh dashboard" className="imagewrapper-big" />
+</p>
+
+## Using SSH
+
+### CLI
+
+For SSH access through the command line interface (CLI), refer to the [CLI documentation](/how-to/cli#ssh) for detailed instructions on establishing SSH connections using the NetBird CLI.
+
+### Browser Client
+
+For SSH access through the Browser Client, refer to the [Browser Client documentation](/how-to/browser-client#ssh-connection) for detailed instructions on establishing SSH connections directly from your web browser.
+
+## Get started
+<p float="center" >
+    <Button name="button" className="button-5" onClick={() => window.open("https://netbird.io/pricing")}>Use NetBird</Button>
+</p>
+
+- Make sure to [star us on GitHub](https://github.com/netbirdio/netbird)
+- Follow us [on X](https://x.com/netbird)
+- Join our [Slack Channel](/slack-url)
+- NetBird [latest release](https://github.com/netbirdio/netbird/releases) on GitHub