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

Download the binary for your OS and unzip it.

Create an Identity

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

If you are planning to run your node on a NAS, Raspberry Pi or other device with less computing power, you can create an Identity on a more powerful machine and then transfer it over to the device you will run your node on.

To create an identity:

1. Open a terminal window.

2. Go to the directory with your identity binary.

3. Use the create command to create an identity:

Windows
Linux
ARM-based OS
macOS

In Powershell, run the following command (leave out the ./ if you are using cmd):

./identity_windows_amd64.exe create storagenode

Your identity will be generated in (Powershell): $Env:APPDATA/Storj/Identity/storagenode

./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

Your identity will be generated in: ~/.local/share/storj/identity/storagenode

./identity_linux_arm create storagenode

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

On Raspberry Pi, your identity will be generated in (the path may vary for other ARM platforms): /home/pi/.local/share/storj/identity/storagenode

./identity_darwin_amd64 create storagenode

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

Your identity will be generated in: /Users/USER/Library/Application Support/Storj/identity/storagenode

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

Sign the Identity

Now, sign the identity you created with your single-use authorization token.

Reminder: The entire string including your email is your authorization token.

Windows
Linux
ARM-based OS
macOS
./identity_windows_amd64.exe authorize storagenode <email:characterstring>
./identity_linux_amd64 authorize storagenode <email:characterstring>
./identity_linux_arm authorize storagenode <email:characterstring>
./identity_darwin_amd64 authorize storagenode <email:characterstring>

If your identity folder only contains 4 files after this step, you did not successfully complete the identity authorization. Signing the identity again until you see 6 files in the identity folder.

Backup the Identity folder

Make a backup of your identity folder, including all 6 files contained in it. This will allow you to restore your node to working order in case of an unfortunate incident such as a hard drive crash. Find your identity folder here:

Windows
Linux
ARM-based OS
macOS

Your identity folder is located in: $Env:APPDATA/Storj/Identity/storagenode

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

On Raspberry Pi, your identity folder is located in (the path may be different for other ARM platforms): /home/pi/.local/share/storj/identity/storagenode

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

Failure to create a complete backup of your identity folder can result in not being able to recover your node later. Save it before you continue!