From 2c00a232ce36dce42d7c9f68db5b2daa9196d870 Mon Sep 17 00:00:00 2001 From: Adam Shiervani Date: Tue, 22 Apr 2025 21:16:07 +0200 Subject: [PATCH 1/7] Update Kickstarter FAQ to reflect changes in retail launch timing and clarify shipping options for backers. --- content/docs/getting-started/ks-faq.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/getting-started/ks-faq.mdx b/content/docs/getting-started/ks-faq.mdx index 933a925..c0dd318 100644 --- a/content/docs/getting-started/ks-faq.mdx +++ b/content/docs/getting-started/ks-faq.mdx @@ -85,7 +85,7 @@ This process helps us stay organized and ensures your JetKVM is shipped to the r ### What courier will you use? -Unfortunately, we can't specify the courier for any country, as shipping is handled by a third-party service rather than directly by us. If this is a critical requirement for you, and you'd like a refund, please reach out to [shipping@jetkvm.com](mailto:shipping@jetkvm.com). When we go retail in March, details like this will be much clearer. +Unfortunately, we can't specify the courier for any country, as shipping is handled by a third-party service rather than directly by us. If this is a critical requirement for you, and you'd like a refund, please reach out to [shipping@jetkvm.com](mailto:shipping@jetkvm.com). When we go retail soon, details like this will be much clearer. ### Will you be able to handle the demand? @@ -102,7 +102,7 @@ However, you have a few options: 1. **Refund and Reback**: I could refund your pledge, and you could back the project again with updated items. Please note that this may result in a later shipping date, so be sure to check the Expected Delivery date. 2. **New Account Option**: If you don't mind paying extra for shipping, you can create a new Kickstarter account and back the project again with the updated items. -3. **Wait for Retail**: Alternatively, if you're not in a rush, we plan to launch the product for retail on platforms like Amazon starting in February. This might be a more convenient option. +3. **Wait for Retail**: Alternatively, if you're not in a rush, we plan to launch the product for retail soon. This might be a more convenient option. Reach out to [contact@jetkvm.com](mailto:contact@jetkvm.com) if you'd like to discuss these options. From 7a78566cefc74c46a1b4a5007d06882ec7e78e46 Mon Sep 17 00:00:00 2001 From: Adam Shiervani Date: Wed, 23 Apr 2025 11:58:00 +0200 Subject: [PATCH 2/7] Update docs --- .../alternative-power-sources.mdx | 2 +- .../docs/peripheral-devices/extension-port.mdx | 17 +++++++++-------- 2 files changed, 10 insertions(+), 9 deletions(-) diff --git a/content/docs/peripheral-devices/alternative-power-sources.mdx b/content/docs/peripheral-devices/alternative-power-sources.mdx index 9751577..17e63f7 100644 --- a/content/docs/peripheral-devices/alternative-power-sources.mdx +++ b/content/docs/peripheral-devices/alternative-power-sources.mdx @@ -1,6 +1,6 @@ --- title: Power Options -description: "Learn how to extend the functionality of your JetKVM device through the customizable RJ-11 extension port." +description: "Learn how to extend the functionality of your JetKVM device through the customizable RJ-12 extension port." order: 7 --- diff --git a/content/docs/peripheral-devices/extension-port.mdx b/content/docs/peripheral-devices/extension-port.mdx index b1d9927..5f093d5 100644 --- a/content/docs/peripheral-devices/extension-port.mdx +++ b/content/docs/peripheral-devices/extension-port.mdx @@ -1,10 +1,10 @@ --- title: "Extension Port" -description: "Learn how to extend the functionality of your JetKVM device through the customizable RJ-11 extension port." +description: "Learn how to extend the functionality of your JetKVM device through the customizable RJ-12 extension port." order: 6 --- -The **JetKVM** features an **RJ-11 extension port** on the back, designed to provide full customizability and flexibility to your device. Whether you're looking to integrate additional hardware capabilities or contribute custom add-ons, the extension port opens up unlimited possibilities for expansion. +The **JetKVM** features an **RJ-12 extension port** on the back, designed to provide full customizability and flexibility to your device. Whether you're looking to integrate additional hardware capabilities or contribute custom add-ons, the extension port opens up unlimited possibilities for expansion. Date: Wed, 23 Apr 2025 12:27:39 +0200 Subject: [PATCH 3/7] Correct documentation regarding the extension package by clarifying the inclusion of a 5.5/2.5 mm male to 5.5/2.5 mm cable instead of an adapter. --- content/docs/peripheral-devices/extension-port.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/peripheral-devices/extension-port.mdx b/content/docs/peripheral-devices/extension-port.mdx index 5f093d5..4bb7492 100644 --- a/content/docs/peripheral-devices/extension-port.mdx +++ b/content/docs/peripheral-devices/extension-port.mdx @@ -59,7 +59,7 @@ Included in the extension package: The extension can **also power the JetKVM itself through the RJ-12 connection**, streamlining setup and reducing the need for additional power sources. -Note: Previously, we wrote that we included a 5.5/2.1mm to 5.5/2.5mm adapter in the extension package. This was incorrect. We are including a only 5.5/2.5 mm male to 5.5/2.5 mm cable in the extension package. +Note: Previously, we wrote that we included a two more adapter in the extension package. This was incorrect. We are including a only 5.5/2.5 mm male to 5.5/2.5 mm cable in the extension package. ### Serial Console From b450d72af8dc72f123c5014e3901ff4aea989aee Mon Sep 17 00:00:00 2001 From: Adam Shiervani Date: Wed, 30 Apr 2025 16:36:18 +0200 Subject: [PATCH 4/7] Update Copyright year --- app/components/landingpage/Footer.tsx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/components/landingpage/Footer.tsx b/app/components/landingpage/Footer.tsx index 775ad06..414ec9e 100644 --- a/app/components/landingpage/Footer.tsx +++ b/app/components/landingpage/Footer.tsx @@ -40,7 +40,7 @@ export default function Footer() {
- © 2024 BuildJet, Inc. - All rights reserved. + © 2025 BuildJet, Inc. - All rights reserved.
From a96797aa4994deb49044c9b03902e32994a81576 Mon Sep 17 00:00:00 2001 From: Adam Shiervani Date: Tue, 8 Jul 2025 17:23:52 +0200 Subject: [PATCH 5/7] Refine Alert component styles, adjust heading level logic in Table of Contents, and enhance Tailwind CSS styles for tables and blockquotes. Update documentation for JetKVM quick start and ATX Power Control Extension installation instructions for clarity and completeness. --- app/components/Alert.tsx | 4 +- app/routes/_landingpage_.docs.$.tsx | 2 +- app/styles/tailwind.css | 36 +++++++++- content/docs/getting-started/faq.mdx | 4 +- content/docs/getting-started/quick-start.mdx | 73 ++++++++++++++++++-- 5 files changed, 107 insertions(+), 12 deletions(-) diff --git a/app/components/Alert.tsx b/app/components/Alert.tsx index 3698e8b..86c7cb6 100644 --- a/app/components/Alert.tsx +++ b/app/components/Alert.tsx @@ -12,7 +12,7 @@ export default function Alert({ BtnElm?: React.ReactNode; }) { return ( - +

{headline}

-
{description}
+
{description}
{BtnElm && BtnElm} diff --git a/app/routes/_landingpage_.docs.$.tsx b/app/routes/_landingpage_.docs.$.tsx index 9051a18..ff62736 100644 --- a/app/routes/_landingpage_.docs.$.tsx +++ b/app/routes/_landingpage_.docs.$.tsx @@ -59,7 +59,7 @@ function transformToHierarchy(headings: Heading[]): TableOfContentsType[] { children: [], }; tableOfContents.push(currentParent); - } else if (heading.level === 3 || heading.level === 4) { + } else if (heading.level === 3) { if (currentParent) { currentParent.children.push({ id: heading.id, diff --git a/app/styles/tailwind.css b/app/styles/tailwind.css index bb84dbb..baa89e7 100644 --- a/app/styles/tailwind.css +++ b/app/styles/tailwind.css @@ -40,8 +40,40 @@ html { @apply scroll-smooth; } +table { + @apply !text-[13px]; +} + +thead { + @apply rounded-md bg-blue-100/50; +} + +th, +thead { + @apply pt-2; +} + +thead th:first-child, +tbody td:first-of-type { + @apply !pl-4; +} + +thead th:not(:first-of-type), +tbody td:not(:first-of-type) { + @apply text-center; +} + +.prose :where(blockquote p:first-of-type):not(:where([class~="not-prose"],[class~="not-prose"] *))::before { + @apply !hidden; +} + +.prose :where(blockquote p:first-of-type):not(:where([class~="not-prose"],[class~="not-prose"] *)) { + @apply not-italic bg-blue-100/50 p-1 rounded-md pl-4 py-2; +} + + td strong { - @apply whitespace-nowrap font-display text-base font-bold text-black; + @apply whitespace-nowrap font-display font-bold text-black; } td a { @@ -49,7 +81,7 @@ td a { } th { - @apply whitespace-nowrap font-display text-base text-black; + @apply whitespace-nowrap font-display text-black; } body { diff --git a/content/docs/getting-started/faq.mdx b/content/docs/getting-started/faq.mdx index 4783438..a561eca 100644 --- a/content/docs/getting-started/faq.mdx +++ b/content/docs/getting-started/faq.mdx @@ -17,8 +17,8 @@ A PoE-capable version of JetKVM is on the roadmap. ### Does it come with Tailscale? -The device doesn't come with Tailscale pre-installed, though as the device is Linux-based, it should be possible to install. -Brandon, a member of the JetKVM community, has created a helpful [Tailscale installer guide on Medium](https://medium.com/@brandontuttle/installing-tailscale-on-a-jetkvm-3c72355b7eb0). Take a look and get started! +The device doesn't come with Tailscale pre-installed. However, since the device is Linux-based, it's possible to install it yourself if desired. +Brandon, a member of the JetKVM community, has created a helpful [Tailscale installer guide on Medium](https://medium.com/@brandontuttle/installing-tailscale-on-a-jetkvm-3c72355b7eb0) that you might find useful if you're interested in setting this up. ### Can I use the device without the Cloud features? diff --git a/content/docs/getting-started/quick-start.mdx b/content/docs/getting-started/quick-start.mdx index 41cb4a5..d2a3c76 100644 --- a/content/docs/getting-started/quick-start.mdx +++ b/content/docs/getting-started/quick-start.mdx @@ -1,9 +1,13 @@ --- title: "Quick Start" -description: "Get started with JetKVM quickly. Learn how to set up your device, understand the front display information, and familiarize yourself with the available ports for remote computer control." +description: "Get started with JetKVM quickly. Learn how to set up your device or extensions, understand the front display information, and familiarize yourself with the available ports for remote computer control." order: 1 --- +## JetKVM + +### Installation + Getting your JetKVM up and running is easy. Follow these steps to start controlling your target computer remotely. 1. Attach the **USB-C port** on the back of the JetKVM to a USB port on the computer you wish to control. @@ -14,9 +18,7 @@ Getting your JetKVM up and running is easy. Follow these steps to start controll You can now control your target computer remotely. ---- - -## Front Display Overview +### Front Display Overview Make sure that you get the layout & polarity(+/-) on all the pins. It matters. + +**4. Connect the Case Front Panel Cables (Optional)** + +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. + +These cables are typically soldered directly to the case and terminate in female ATX pin connectors, usually labeled for power, reset, and LED indicators. + +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. + + +| JetKVM ATX Board Label | Front Panel ribbon cable Label | Polarity(+/-) Matters? | +| ---------------------- | ------------------------------ | ------------------------------ | +| BTN PWR + / – | Power SW | No | +| BTN RST + / – | Reset SW | No | +| LED HDD + / – | HDD LED | Yes, check manual for polarity | +| LED PWR + / – | Power LED | Yes, check manual for polarity | + + +> Make sure that you get the layout & polarity(+/-) for LED HDD & LED PWR. It matters. + +--- + +Now that everything is connected, head over to the JetKVM web interface by entering the device’s IP address in your browser. In the JetKVM toolbar, click on “Extension” to access the ATX controls. If everything is configured correctly, you should now be able to power on, reset, or shut down your PC remotely - directly from the JetKVM interface. From a57baa5dada391a0d0e096d76667d1909a20effb Mon Sep 17 00:00:00 2001 From: James Holland <6574404+jamesholland-uk@users.noreply.github.com> Date: Wed, 9 Jul 2025 14:55:19 +0100 Subject: [PATCH 6/7] Adds outbound connectivity requirements (#25) * Adds outbound connectivity requirements * Updates after review, including more clarity on destinations --- content/docs/networking/local-access.mdx | 32 ++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/content/docs/networking/local-access.mdx b/content/docs/networking/local-access.mdx index 240a0fd..fa2da91 100644 --- a/content/docs/networking/local-access.mdx +++ b/content/docs/networking/local-access.mdx @@ -25,6 +25,38 @@ You can modify the password settings at any time, either during the onboarding p - **Update Password:** You can update the password if needed by entering a new one. - **Delete Password:** This action removes the password, allowing password-less access to the device. +## Outbound Internet Connectivity + +The following outbound connectivity is required, from the JetKVM towards the Internet: + +### JetKVM System Updates + +Updates use HTTPS (tcp/443) towards the following FQDNs: + +- update.jetkvm.com +- api.jetkvm.com +- app.jetkvm.com + +### Time Synchronization + +Users have the option to select NTP (udp/123) and/or HTTP (tcp/80) in the Network Settings, for time synchronization to happen towards the following FQDNs: + +NTP (udp/123): +- time.apple.com +- time.aws.com +- time.windows.com +- time.google.com +- time.cloudflare.com (hardcoded to IPv4 162.159.200.123 and IPv6 2606:4700:f1::123) +- 0.pool.ntp.org +- 1.pool.ntp.org +- 2.pool.ntp.org +- 3.pool.ntp.org + +HTTP (tcp/80): +- http://www.gstatic.com/generate_204 +- http://cp.cloudflare.com/ +- http://edge-http.microsoft.com/captiveportal/generate_204 + ## Reset Password If you've forgotten your local password, there are two ways to reset it: From cb20be5699ee656fb09e42b1345ac39dc9cecd6b Mon Sep 17 00:00:00 2001 From: Frollir <45204318+Frollir@users.noreply.github.com> Date: Wed, 9 Jul 2025 14:55:34 +0100 Subject: [PATCH 7/7] Fixed typo (#19) --- content/docs/advanced-usage/developing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/advanced-usage/developing.mdx b/content/docs/advanced-usage/developing.mdx index 5673662..f121f43 100644 --- a/content/docs/advanced-usage/developing.mdx +++ b/content/docs/advanced-usage/developing.mdx @@ -8,7 +8,7 @@ JetKVM is built with developers in mind, providing tools and modes that allow yo ## Developer Mode -Developer Mode unlocks SSH access to the JetKVM device, allowing you to customize or modify the system. When you enable Developer Mode, you must provide an **SSH public key**, as JetKVM uses key-based authentication. **For security reasons, you can not user your JetKVM password for SSH logins.** +Developer Mode unlocks SSH access to the JetKVM device, allowing you to customize or modify the system. When you enable Developer Mode, you must provide an **SSH public key**, as JetKVM uses key-based authentication. **For security reasons, you can not use your JetKVM password for SSH logins.** Once enabled, you can SSH into the JetKVM device, explore the system, and run your own applications. The system runs on a lightweight Linux environment using **BusyBox** as the core user space and **DropBear** as the SSH server.