Linux & MacOS Installation Guide
Installation of client and server software
For more control of the installation look at the Manual Installation Guides.
Legend | Meaning |
---|---|
Client Side | |
Device side | |
<REPLACE> | Fill in with your details |
🖥️ Step 1: Install on the Client machine
If you don't own a pair of atSigns/addresses, please visit the registrar before continuing
(1.1) Download the Installer
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:
To check if the installation downloaded correctly:
(1.2) Run the Installer
Make the script executable and run the script.
Type in client
when asked for what type of install. Continue following along with the instructions provided with the installer until the installation is complete.
Useful tips when answering the client installation
Your client atSign should look like : @sshnp_client
Your device atSign should look like: @sshnp_device
Device name should look like: my_host, pi3, home_server_2
This command activates your atSign and prompts you to enter an OTP. This is only done during the setup of a brand new atsign.
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 master keys will save at ~/.atsign/keys
.
This command activates your atSign and prompts you to enter an OTP. This is only done during the setup of a brand new atsign.
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 master keys will save at ~/.atsign/keys
.
Your client machine software installation is completed. Now, on to the device/server
🖨️ Step 2 : Installing the Device
(2.1) Download the installer
To check if the installation downloaded correctly:
(2.2) Run the installer
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 atSigns
(3.1) 🖥️: Generate a passcode
On the client machine, run the following command. It should output a 6-character passcode.
(3.2) 🖨️: Make an authorization request from your device machine
On the device machine, run the following command, using the DEVICE_NAME that you chose while running the installer earlier
Once you see this text, you're ready to continue to the next step.
(3.3) 🖥️: Approve the authorization request
On the client machine, run the following command
Installation Complete! You are ready to use SSH No Ports, visit the sshnp Usage.
Last updated