Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Copy of Quick Start from macOS or Windows

How to quickly install and try NoPorts on both MacOS and Windows devices.

This guide is intended for people connecting from a machine running Windows or macOS.

For people connecting from Linux please follow the Linux Installation Guide.

Step 1: Sign up for a NoPorts free trial

Go to noports.com and sign up for a subscription or free trial

Make note of your atSigns (e.g., @example01_np, @example02_np). You'll need them shortly.

Step 2: Download the NoPorts desktop application

Download the NoPorts desktop app using one of the links below:

Link to Apple Store

Link to Windows Store

For people connecting from Linux please follow the Linux Installation Guide.

Step 3: Activate your client atSign (@example01_np)

In this installation guide, @example01_np will represent the client atSign, while @example02_np will represent the device atSign.

  1. Launch the NoPorts desktop app and click Get Started.

  2. Enter your client atSign into the text field (e.g., @example01_np), leave the root domain as is, and then click Next.

  3. A one-time password (OTP) will be sent to you via email. Enter this OTP into the app and then click Confirm.

For Windows, if the app stalls at "Preparing for activation", verify that your CA certificates are up to date.

Step 4: Save a copy of your client atKeys

Your atKeys (cryptographic keys) will be used to pair your atSign with this and other devices in future. You can learn more about these keys here.

  1. Click on Save atKeys

  2. Select a memorable location on your machine and save your keys.

Step 5: Establish a connection

Connection Options You can either connect to your own remote machine or use our hidden test connection page.

  • Remote machine setup: Activate a second atSign, install NoPorts on the remote machine, and create a connection profile in the desktop app (about 10 minutes).

  • Test connection: Use the hidden test page for a quicker option.

Select a tab below to continue.

Step 5.1: Activate your device atSign (@example02_np)

Both the atSigns are activated on the machine you are connecting from. Later, you’ll grant your remote machine access to the keys stored on this machine.

  1. You'll need to switch atSigns. To sign out from the client atSign, click on your atSign at the top right of the screen, then select Sign Out.

  2. Click Get Started and enter your device atSign into the text field (e.g., @example02_np). Leave the root domain as is, and then click Next.

  3. A one-time password (OTP) will be sent to you via email. Enter this OTP into the app and then click Confirm.

Step 5.2: Save a copy of your device atKeys

Your atKeys (cryptographic keys) will be used to pair your atSign with this and other devices in future. You can learn more about these keys here.

  1. Click on Save atKeys

  2. Select a memorable location on your machine and save your keys.

Step 5.3: Generate a device atSign authorization passcode

Click on Authenticator at the top of the screen and then click on OTP. You will use this 4 character code in Step 7.

Step 5.4: Switch to the machine you are connecting to

Please select the operating system running on the machine you are connecting to and follow the relevant instructions:

macOS

Linux

Windows

  1. On the Connections tab, you'll see a banner saying "Demo. Click here to load the test profile." Click Try Now.

  2. Once the profile has been added to your list, click the Connect Icon ▶️ to establish a connection.

  3. Open a web browser and navigate tohttp://localhost:8080.

Congratulations! You're connected to a hidden webpage via NoPorts!

Last updated