Identity

Every node is required to have a unique identifier on the network.

Get an authorization token

If you haven't already, get an authorization token. This is required to continue.

Download the Identity Binary

Open a terminal window and paste the command for your OS:

Windows
Linux
ARM-based OS
macOS
Windows

PowerShell:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; curl https://github.com/storj/storj/releases/latest/download/identity_windows_amd64.exe.zip -o identity_windows_amd64.exe.zip; Expand-Archive ./identity_windows_amd64.exe.zip . -Force
Linux
curl -L https://github.com/storj/storj/releases/latest/download/identity_linux_amd64.zip -o identity_linux_amd64.zip
unzip -o identity_linux_amd64.zip
chmod +x identity_linux_amd64
ARM-based OS

Raspberry PI:

curl -L https://github.com/storj/storj/releases/latest/download/identity_linux_arm.zip -o identity_linux_arm.zip
unzip -o identity_linux_arm.zip
chmod +x identity_linux_arm

Computers Capable of the AARCH64 Instruction Set:

curl -L https://github.com/storj/storj/releases/latest/download/identity_linux_arm64.zip -o identity_linux_arm64.zip
unzip -o identity_linux_arm64.zip
chmod +x identity_linux_arm64
macOS
curl -L https://github.com/storj/storj/releases/latest/download/identity_darwin_amd64.zip -o identity_darwin_amd64.zip
unzip -o identity_darwin_amd64.zip
chmod +x identity_darwin_amd64
sudo mv identity_darwin_amd64 /usr/local/bin/identity

Create an identity

This can take several hours or days, depending on your machines processing power and luck.

Plan to run your Node on a NAS, Raspberry Pi or similar? Create your identity on a more powerful machine and transfer it over.

Windows
Linux
ARM-based OS
macOS
Windows

PowerShell:

./identity_windows_amd64.exe create storagenode

Command Prompt:

identity_windows_amd64.exe create storagenode
Linux
./identity_linux_amd64 create storagenode

If you are unable to execute the command, be sure that you set your file permission to executable: chmod +x identity_linux_amd64

ARM-based OS
ARM 32 bit (raspberry Pi)
./identity_linux_arm create storagenode
ARM 64 bit
./identity_linux_arm64 create storagenode

If you are unable to execute the command, be sure that you set your file permission to executable:

ARM 32 bit
chmod +x identity_linux_arm
ARM 64 bit
chmod +x identity_linux_arm64
macOS
identity create storagenode

Not working? Set your file permission to executable.

4. This process will continue until it reaches a difficulty of at least 36. On completion, it will look something like this:

Authorize the identity

Open your Storj Node invitation email and copy your single-use authorization token:

Authorize your Storage Node identity using your single-use authorization token:

Windows
Linux
ARM-based OS
macOS
Windows

PowerShell:

./identity_windows_amd64.exe authorize storagenode <email:characterstring>

Command Prompt:

identity_windows_amd64.exe authorize storagenode <email:characterstring>
Linux
./identity_linux_amd64 authorize storagenode <email:characterstring>
ARM-based OS
ARM 32 bit
./identity_linux_arm authorize storagenode <email:characterstring>
ARM 64 bit
./identity_linux_arm64 authorize storagenode <email:characterstring>
macOS
identity authorize storagenode <email:characterstring>

Confirm the identity

Run the following command to confirm you have the required identity files:

Windows
Linux
macOS
Windows

PowerShell:

(sls BEGIN $env:AppData\Storj\Identity\storagenode\ca.cert).count
(sls BEGIN $env:AppData\Storj\Identity\storagenode\identity.cert).count
Linux
grep -c BEGIN ~/.local/share/storj/identity/storagenode/ca.cert
grep -c BEGIN ~/.local/share/storj/identity/storagenode/identity.cert
macOS
grep -c BEGIN ~/Library/Application\ Support/Storj/identity/storagenode/ca.cert
grep -c BEGIN ~/Library/Application\ Support/Storj/identity/storagenode/identity.cert

The first command should return 2, and the second command should return 3:

If your numbers are different, then authorizing the identity was not successful. Please try again.

Might move your storage node to another machine in the future? Back up your identity folder.

Backup the identity

Backup before you continue, it should be quick! 🙏

This allows you to restore your Node in case of an unfortunate hardware or OS incident.

Use an external device and backup your identity folder:

Windows
Linux
ARM-based OS
macOS
Windows

Your identity folder is located in (PowerShell): start "$Env:APPDATA/Storj/Identity/storagenode"

In Command Prompt or Windows Explorer: start %APPDATA%\Storj\Identity\storagenode

Linux

Your identity folder is located in: ~/.local/share/storj/identity/storagenode

ARM-based OS

On Raspberry Pi, your identity folder is located in: /home/pi/.local/share/storj/identity/storagenode

macOS

Your identity folder is located in: /Users/USER/Library/Application Support/Storj/identity/storagenode

Next up, select your installation method: