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 NoPorts or log into the NoPorts Management Portal

If you have not already signed up or purchased NoPorts, go to my.noports.com and sign up for a subscription or free trial then proceed to Step 2. If you already have a NoPorts account, you’ll need to start by logging into the Management Portal. Go to my.noports.com/login and enter your registered email address to receive your one‑time password. Once logged in, select the subscription for the Atsigns you want to activate, then continue with the instructions below.

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

Step 2: Initiate Atsign activation in the Management Portal

1. Click Activate All and wait for the activation file to be generated.

2. Once its completed, download the activation file. It should look something like youratsigns_activation_file.yaml.

Step 3: 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 4: Complete Atsign activation in the NoPorts desktop application

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

1. Launch the NoPorts desktop application and click Get Started and then click Complete Activation

2. Upload or drag and drop you activation file (.yaml) and then click Next.

If you don’t have an activation file, you can activate your Atsigns individually by entering each one in the Manual Atsign section and following the steps provided in the app.

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

Step 4: Save your 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.

All your Atsigns will be activated and the keys will be saved in your chosen location.

Step 5: Generate a device atSign authorization passcode

Once the activation process is complete you will be signed in using one of your activated Atsigns. This will be your device Atsign, e.g. @example02_np.

Click on Authenticator at the top of the screen and then click on OTP. Take note of the 6-character code as you will use it in Step 8.

Step 6: Switch to the machine you are connecting to OR use a demo profile to access our test page

Now that your atSigns are ready, you can either set up your remote machine or try our hidden test page.

• Remote machine setup: Install NoPorts on the remote machine, authorize atSign access to the remote machine and create a connection profile in the desktop app (about 10 minutes).

• Test page: Try our demo profile to access our hidden test page if you don't have a machine to connect to.

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

macOS

Linux

Windows

OR Test Page

1. In the NoPorts desktop application, 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!