LogoLogo
  • Home
  • Installation
    • Quick Start for MacOS and Windows
    • MacOS Installation Guides
      • MacOS Desktop Client Installation
      • MacOS CLI Client Installation
      • MacOS Device Installation
    • Linux Installation Guide
      • Linux Cli Client Installation
      • Linux Device Installation
    • Windows Installation Guide
      • Windows Desktop Client Installation
      • Windows CLI Client Installation
      • Windows Device Installation
    • Manual Installation Guides
      • Device installation
        • Tmux session
        • Standalone Binaries
        • Systemd Unit
        • Headless
      • Device Upgrade
      • Installs at scale
      • Client installation
      • Client Upgrade
    • OpenWrt Installation Guide
    • Custom OS/Device Installs
      • IPFire
    • Cloud Installation Guides
      • Automated Installation on Amazon Web Services (AWS)
      • Automated Installation on Google Cloud Platform (GCP)
      • Automated Installation on Microsoft Azure
      • Automated Installation on Oracle Cloud Infrastructure (OCI)
    • Available Releases
  • Installation FAQ
    • How to activate an atSign
    • Reuse your client atSign on another machine
      • Generate a new set of cryptographic keys
    • How to name a device
    • How to generate SSH keys
    • Why activate the device atSign on the client?
  • Usage
    • npt Usage
      • Additional Configuration
    • sshnp Usage
      • Client Additional Configuration
    • sshnpd configuration
      • Daemon Additional Configuration
  • Integrations
    • OpenSSH config
    • PuTTY config
  • Use Cases
    • SSH
    • SFTP
    • RDP
    • Web Server
    • SMB
    • Be your own VPN
  • Product Information
    • NoPorts Policy Service
    • FAQ
    • How It Works
    • Under The Hood
    • Sequence Diagram
  • Related Pages
    • Main Site
    • GitHub
Powered by GitBook
On this page
Edit on GitHub
Export as PDF
  1. Installation
  2. Linux Installation Guide

Linux Device Installation

PreviousLinux Cli Client InstallationNextWindows Installation Guide

Last updated 19 days ago

Choose the operating system which is running on your CLIENT machine:

Step 1 : Activate the device atSign from your CLIENT machine

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

(1.1) Download the activation software on the client machine

(1.2) Run the installer

(1.3) Activate the device atSign from the client machine

Step 2 : Installing on the DEVICE machine

(2.1) Download the installer

(2.2) Run the installer

Step 3: Authorizing the device atSign

(3.1) Generate a passcode from your client machine

(3.2) Make an authorization request from your device machine

(3.3) Approve the authorization request from your client machine

Step 1 : Activate the device atSign from your CLIENT machine

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

(1.1) Download the activation software on the client machine

(1.2) Run the installer

(1.3) Activate the device atSign from the client machine

Step 2 : Installing on the DEVICE machine

(2.1) Download the installer

(2.2) Run the installer

Step 3: Authorizing the device atSign

(3.1) Generate a passcode from your client machine

(3.2) Make an authorization request from your device machine

(3.3) Approve the authorization request from your client machine

Step 1 : Activate the device atSign from your CLIENT machine

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

(1.1) Download the activation software on the client machine

(1.2) Activate the device atSign from the client machine

Step 2 : Installing on the DEVICE machine

(3.3) Approve the authorization request from your client machine

See the Windows

CLI Client Installation

Run the following command

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

Run the following command

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

Run the following command

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

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

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

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

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

Make the script executable and run the script.

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

Make the script executable and run the script.

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

Make the script executable and run the script.

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

Make the script executable and run the script.

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

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.

To check if the installation downloaded correctly:

To check if the installation downloaded correctly:

To check if the installation downloaded correctly:

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.

To check if the installation downloaded correctly:

curl -L https://github.com/atsign-foundation/noports/releases/latest/download/universal.sh -o universal.sh
stat universal.sh
curl -L https://github.com/atsign-foundation/noports/releases/latest/download/universal.sh -o universal.sh
stat universal.sh
curl -L https://github.com/atsign-foundation/noports/releases/latest/download/universal.sh -o universal.sh
stat universal.sh
curl -L https://github.com/atsign-foundation/noports/releases/latest/download/universal.sh -o universal.sh
stat universal.sh
~/.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
~/.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
~/.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

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

C:\\Program\ Files\\NoPorts\\at_activate.exe otp -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.