Node Operator
Search…
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
PowerShell:
1
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; curl https://github.com/storj/storj/releases/latest/download/identity_windows_amd64.zip -o identity_windows_amd64.zip; Expand-Archive ./identity_windows_amd64.zip . -Force
Copied!
1
curl -L https://github.com/storj/storj/releases/latest/download/identity_linux_amd64.zip -o identity_linux_amd64.zip
2
unzip -o identity_linux_amd64.zip
3
chmod +x identity
4
sudo mv identity /usr/local/bin/identity
Copied!

ARM-based OS

Raspberry PI:
1
curl -L https://github.com/storj/storj/releases/latest/download/identity_linux_arm.zip -o identity_linux_arm.zip
2
unzip -o identity_linux_arm.zip
3
chmod +x identity
4
sudo mv identity /usr/local/bin/identity
Copied!
Devices Capable of the AARCH64 Instruction Set:
1
curl -L https://github.com/storj/storj/releases/latest/download/identity_linux_arm64.zip -o identity_linux_arm64.zip
2
unzip -o identity_linux_arm64.zip
3
chmod +x identity
4
sudo mv identity /usr/local/bin/identity
Copied!
1
curl -L https://github.com/storj/storj/releases/latest/download/identity_darwin_amd64.zip -o identity_darwin_amd64.zip
2
unzip -o identity_darwin_amd64.zip
3
chmod +x identity
4
sudo mv identity /usr/local/bin/identity
Copied!

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
PowerShell:
1
./identity.exe create storagenode
Copied!
Command Prompt:
1
identity.exe create storagenode
Copied!
1
identity create storagenode
Copied!
If you are unable to execute the command, be sure that you set your file permission to executable: chmod +x identity
1
identity create storagenode
Copied!
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 (please, replace the placeholder <email:characterstring> to your actual authorization token):
Windows
Linux
macOS
PowerShell:
1
./identity.exe authorize storagenode <email:characterstring>
Copied!
Command Prompt:
1
identity.exe authorize storagenode <email:characterstring>
Copied!
1
identity authorize storagenode <email:characterstring>
Copied!
1
identity authorize storagenode <email:characterstring>
Copied!

Confirm the identity

Run the following command to confirm you have the required identity files:
Windows
Linux
macOS
PowerShell:
1
(sls BEGIN "$env:AppData\Storj\Identity\storagenode\ca.cert").count
Copied!
1
(sls BEGIN "$env:AppData\Storj\Identity\storagenode\identity.cert").count
Copied!
Command Prompt:
1
findstr "BEGIN" "%APPDATA%\Storj\Identity\storagenode\ca.cert" | find /c /v ""
Copied!
1
findstr "BEGIN" "%APPDATA%\Storj\Identity\storagenode\identity.cert" | find /c /v ""
Copied!
1
grep -c BEGIN ~/.local/share/storj/identity/storagenode/ca.cert
Copied!
1
grep -c BEGIN ~/.local/share/storj/identity/storagenode/identity.cert
Copied!
1
grep -c BEGIN ~/Library/Application\ Support/Storj/identity/storagenode/ca.cert
Copied!
1
grep -c BEGIN ~/Library/Application\ Support/Storj/identity/storagenode/identity.cert
Copied!
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
Your identity folder is located in (PowerShell): start "$Env:APPDATA/Storj/Identity/storagenode"
In Command Prompt or Windows Explorer: start "%APPDATA%\Storj\Identity\storagenode"
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
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:

Last modified 10mo ago