3 |
4 | ### Documentation
5 |
6 | [Discord](https://jetkvm.com/discord) | [Website](https://jetkvm.com) | [Issues](https://github.com/jetkvm/website/issues) | [Docs](https://jetkvm.com/docs)
7 |
8 | [](https://twitter.com/jetkvm)
9 |
10 | Connect with our community, get support, and stay updated on the latest news.
27 |Get quick updates, tips, and engage with the JetKVM team on X (formerly Twitter).
41 |
30 |
31 | ### Zero Trust Security Model
32 |
33 | To further enhance security, JetKVM employs a **Zero Trust security model**. In Zero Trust, the principle is to "never trust, always verify." This means the device itself is responsible for determining whether an authentication request is valid—there is no central server involved in verifying credentials. JetKVM uses **OIDC (OpenID Connect)** for authentication, currently supporting only Google accounts. Additional OIDC providers may be added in the future.
34 |
35 | ### Stun and Turn Servers
36 |
37 | In most cases, WebRTC establishes direct peer-to-peer connections. However, network restrictions like firewalls or strict NAT policies can prevent direct communication between devices. To solve this, JetKVM, through Cloudflare, provides free STUN and TURN servers for cases where WebRTC requires additional support.
38 |
39 | #### STUN Servers
40 |
41 | **STUN (Session Traversal Utilities for NAT)** servers help devices behind NAT (Network Address Translation) determine their public IP address and port. This process facilitates peer-to-peer connections in most scenarios, even when devices are located in different network environments.
42 |
43 | #### TURN Servers
44 |
45 | When STUN is not enough, such as in more complex network setups with strict NAT policies, **TURN (Traversal Using Relays around NAT)** servers become necessary. TURN servers act as intermediaries that relay traffic between devices, bypassing firewalls and restrictive NAT configurations. TURN servers are particularly important when direct peer-to-peer communication fails, such as when devices are behind **Carrier-Grade NAT (CGNAT)**, often seen in mobile networks.
46 |
47 | ## Tailscale
48 |
49 | Tailscale is not pre-installed on the device. However, Tailscale has added out-of-the-box support for JetKVM, which means you can easily install Tailscale on your device remotely from your computer.
50 |
51 | 1. [Add your SSH key to JetKVM](https://jetkvm.com/docs/advanced-usage/developing#developer-mode)
52 | 2. **On your local computer** (not on the JetKVM device), run the following command and follow the instructions:
53 |
54 | ```bash
55 | curl -fsSL https://jetkvm.com/install-tailscale.sh | sh -s -- 
14 |
15 | ## What is the Extension Port?
16 |
17 | The **RJ-12 extension port** functions as a serial port, allowing communication with the JetKVM. This port is key to adding extra hardware and functionality to the device, making it a highly versatile component.
18 |
19 | These add-ons are available for purchase, but the port isn't limited to just JetKVM's accessories—**it's open for anyone to develop their own custom extensions**.
20 |
21 | ---
22 |
23 | ### ATX Power Control
24 |
25 | 
33 | 
55 | 
81 | 
111 | 
28 |
29 | The front display of the JetKVM provides key information at a glance. Here’s what each section of the display shows:
30 |
31 | - **Device IP**: The IP address assigned to your device by the network, allowing you to access the web UI.
32 | - **Device MAC**: The unique MAC address of the device.
33 | - **Active Connections**: Displays the number of active connections currently in use.
34 | - **HDMI Cable Status**: Shows whether the HDMI connection to the target computer is active.
35 | - **USB Cable Status**: Indicates whether the USB connection to the target computer is active.
36 |
37 | This information helps you quickly verify if your JetKVM is properly connected and ready for remote management.
38 |
39 | ---
40 |
41 | ### Ports Overview
42 |
43 | 
48 | Here's a look at the available ports on your JetKVM device:
49 |
50 | - **USB-C**: For connecting to the target computer.
51 | - **HDMI Mini**: For receiving the video signal from the target computer.
52 | - **Ethernet - RJ45**: For network connectivity.
53 | - **Extension Port - RJ11**: For additional features like ATX power control, Serial Console access, or AC/DC power control.
54 |
55 | ## ATX Power Control Extension
56 |
57 | The JetKVM ATX Power Control Extension allows you to remotely power on, reset, and monitor your PC - without losing your front panel buttons and LEDs. This guide walks you through installing it safely and clearly.
58 |
59 | - **ATX Extension Board** - Extension board with USB-C and RJ12 ports that mounts inside PC case like a slot card
60 | - **RJ12 Cable** - Links ATX board to JetKVM device
61 | - **PCIe Slot Cover Brackets** - Brackets for routing in different case sizes (standard and small options)
62 | - **Ribbon Cables** - Female-to-female connectors used to link the ATX board to your motherboard’s `F_PANEL` header.
63 |
64 | ### Installation
65 | **1. Power Down and Prepare Your PC**
66 |
67 | Let's make sure everything's safe before working inside your case.
68 |
69 | 1. **Shut down your PC** completely through the operating system
70 | 2. **Flip the PSU switch to OFF** (usually located on the back of the power supply)
71 | 3. **Unplug the power cable** from the wall or power strip
72 | 4. **Ground yourself** by touching something metal (like the case frame)
73 | 5. **Set up your workspace** with tools and lighting nearby - you'll mainly need a Phillips screwdriver
74 |
75 | **2. Mount the ATX board in the case**
76 |
77 | Let’s physically install the board in a free slot. We include two bracket sizes, choose the one that fits your case the best.
78 |
79 | 1. **Pick any empty PCI/PCIe slot opening** (it doesn’t use electrical contacts, just mounting space).
80 | 2. **Slide the board in** and secure the metal bracket with a screw.
81 |
82 | #### 3. Connect ATX Extension to motherboard
83 | Locate the `F_PANEL` header on your motherboard. It’s usually a small white or black 9- or 10-pin block labeled `F_PANEL`, `PANEL1`, or `FP1`.
84 |
85 | If you've previously connected your front panel controls to your motherboard, disconnect them from the motherboard now (we'll reconnect them later).
86 |
87 | Using your motherboard manual as a reference, **identify the specific layout and polarity of your motherboard pins** to match and connect it with the labels on the JetKVM ATX Board.
88 |
89 | **This step is a common source of installation errors**, so take extra care to match both the pin layout and polarity (+/-) with the labels on the JetKVM ATX Board. If you don't have your motherboard manual handy, you can usually find it by searching for your motherboard model number followed by "manual" online.
90 |
91 | > Make sure that you get the layout & polarity(+/-) on all the pins. It matters.
92 |
93 | **4. Connect the Case Front Panel Cables (Optional)**
94 |
95 | If you want to have control of your computer from the front panel, you'll need to connect them to the JetKVM, which will forward the signals to the motherboard.
96 |
97 | These cables are typically soldered directly to the case and terminate in female ATX pin connectors, usually labeled for power, reset, and LED indicators.
98 |
99 | In the previous step, we likely disconnected these cables from the motherboard. Now, connect them to the corresponding pins on the JetKVM ATX board using the pinout guide below. Be sure to match the polarity(+/-) on the LED Pins - proper polarity is essential for it to work correctly.
100 |
101 |