Edit

Windows to macOS

How to install NoPorts when connecting from Windows to macOS

Step 1 to Step 4

These initial steps set up the machine initiating the connection.

On the machine you are connecting from

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

Step 1: Download and run the Installer

Download the installer from GitHub. Then unzip the file.

Launch the NoPortsInstaller.exe program and allow it administrative permissions. Click Client Install and follow the process until installation is complete.

Step 2: Activate your client atSign (@example01_np)

If you've already activated your client atSign on another device, this step will not work. Instead, follow this guide: Reuse your client atSign on another machine

Step 2.1 Click on Activate atSign.

Step 2.2 Enter the atSign you wish to activate and click Submit.

Step 2.3 Check your email for the OTP (one-time password), then enter it and press Generate.

Step 2.4 Once activated, the master keys will save at ~/.atsign/keys. Wait for the keys to generate, then go back Home.

Step 3: Activate your device atSign (@example02_np)

Repeat the activation process, but for your device atSign. The device master keys will also save at ~/.atsign/keys.

Step 4: Generate an atSign authorization passcode for your device atSign

Follow the steps below to generate a 6-character one-time passcode which you will use in Step 6.

4.1 Click Manage Keys.

4.2 Enter your device atSign and click Next.

4.3 Click New OTP.

4.4 Wait a few seconds for the OTP to appear then proceed to Step 5 on the machine you are connecting to.

Step 5 and Step 6

After setting up the machine you're connecting from, you'll configure the machine you're connecting to.

On the machine you are connecting to

Step 5: Download and run the Installer

Download the installer from Github by running the following command:

curl -L https://github.com/atsign-foundation/noports/releases/latest/download/universal.sh -o universal.sh

To check if the installation downloaded correctly:

stat universal.sh

Make the script executable and run the script by running the command below:

chmod u+x universal.sh
./universal.sh

During installation, you’ll be prompted to enter the following items:

You may be asked to enter your password if your machine requires sudo privileges.

The install type

  • Enter device when prompted.

Your atSigns

  • Client atSign: e.g., @example01_np

  • Device atSign: e.g., @example02_np

Your device name

  • This should be the name of the machine you're currently installing on.

Step 6: Initiate atSign authorization request

Run the following command to make an authorization request.

Be sure to replace the following values:

@<REPLACE>_np with your device atSign,

<PASSCODE> with the passcode generated in Step 4,

@<REPLACE>_np_key with your device atSign,

<DEVICE_NAME> with the name of the machine you are on

~/.local/bin/at_activate enroll -a @<REPLACE>_np \
  -s <PASSCODE> \
  -p noports \
  -k ~/.atsign/keys/@<REPLACE>_np_key.atKeys \
  -d <DEVICE_NAME> \
  -n "sshnp:rw,sshrvd:rw"

Once you see this text, you're ready to continue to the next step.

Submitting enrollment request 
Enrollment ID: ---------------------
Waiting for approval; will check every 10 seconds

Step 7 and Step 8

With both machines now configured, the final steps bring us back to the machine initiating the connection.

On the machine you are connecting from

Step 7: Approve the atSign authorization request

Click Refresh and the new request will appear.

  • If the request looks incorrect, press Deny to deny it and start the process again.

  • If the request looks correct, press Approve to approve it.

Once approved, the request will disappear from the list. On the machine you are connecting to, it will take a few seconds to process the approval.

Step 8: Use NoPorts!

That's it. You can start using NoPorts or explore some of the documented use cases, including MCP, SSH, RDP, SFTP, Web Server, and SMB.

Connecting more machines to your device atSign

To connect more machines to your device atSign, repeat Steps 4 through 7.

Last updated