MacOS Device Installation

If you don't already have a NoPorts client setup, start there before setting up the device.

Step 1 : Activate the device atSign from your client machine

If you've already activated the device atSign skip to step 2.

Even though this atSign is for the device, we recommend activating it from your client.

More info: Why activate the device atSign on the client?

(1.1) Download the activation software on the client machine

First, make sure that you have curl available on your system, curl is a common shell utility.

The following command will download the universal.sh bash installer into your current directory:

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

To check if the installation downloaded correctly:

ls | grep -w "universal.sh"

(1.2) Run the installer

Make the script executable and run the script.

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

Type in client when asked for what type of install. You can either complete the install to have full client support, or press ctrl + c when it asks for more information to skip the rest of the client installation.

(1.3) Activate the device atSign from the client machine

This command activates your atSign and prompts you to enter an OTP. This is only done during the setup of a brand new atsign.

~/.local/bin/at_activate -a @<REPLACE>_device

Enter the One Time Password (OTP) & Check your SPAM/PROMOTIONS folders

at_activate will pause and wait for the input of a one time pin (OTP) sent to your email or phone number.

Once activated, the management keys will be saved in ~/.atsign/keys.

Step 2 : Installing on the device

(2.1) Download the installer

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

To check if the installation downloaded correctly:

ls | grep -w "universal.sh"

(2.2) Run the installer

Make the script executable and run the script.

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

The script will guide you through the installation process. It will prompt you for the information you need. Make sure you type in device when it asks what type of installation. You will need the client atSign, device atSign and the device name. making sure they match your earlier choices.

---

Step 3: Authorizing the device atSign

(3.1) Generate a passcode from your client machine

Run the following command. It should output a 6-character passcode.

~/.local/bin/at_activate otp -a @<REPLACE>_device

(3.2) Make an authorization request from your device machine

~/.local/bin/at_activate enroll -a @<REPLACE>_device \
  -s <PASSCODE> \
  -p noports \
  -k ~/.atsign/keys/@<REPLACE>_device_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

(3.3) Approve the authorization request from your client machine

Run the following command

~/.local/bin/at_activate approve -a @<REPLACE>_device \
  --arx noports \
  --drx <DEVICE_NAME>

Installation Complete! You are ready to use No Ports, visit Usage!