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 as a usual user (not administrator or root) and paste the command for your OS:

Windows
Linux
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
sudo mv identity /usr/local/bin/identity

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
sudo mv identity /usr/local/bin/identity

Devices 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
sudo mv identity /usr/local/bin/identity
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
sudo mv identity /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
macOS
Windows

PowerShell:

./identity.exe create storagenode

Command Prompt:

identity.exe create storagenode
Linux
identity create storagenode

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

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
macOS
Windows

PowerShell:

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

Command Prompt:

identity.exe authorize storagenode <email:characterstring>
Linux
identity 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

Command Prompt:

findstr "BEGIN" "%APPDATA%\Storj\Identity\storagenode\ca.cert" | find /c /v ""
findstr "BEGIN" "%APPDATA%\Storj\Identity\storagenode\identity.cert" | find /c /v ""
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
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

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

Optional: Move the identity to the subfolder in the storage location

It's not required, but could prevent the storagenode from start, if the mounted disk is inaccessible.

Unfortunately this trick will not help, if the disk would disappear while the storagenode running.

Next up, select your installation method: