Storj IconSTORJ | Node Operator Docs
Identity

Identity #

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:

PowerShell:

[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
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
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
curl -L https://github.com/storj/storj/releases/latest/download/identity_darwin_arm64.zip -o identity_darwin_arm64.zip
unzip -o identity_darwin_arm64.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.

PowerShell:

./identity.exe create storagenode

Command Prompt:

identity.exe create storagenode
identity create storagenode

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

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 #

Copy your single-use authorization token from the Node Hosting signup page:

Authorize your Storage Node identity using your single-use authorization token (please, replace the placeholder <email:characterstring> to your actual authorization token):

PowerShell:

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

Command Prompt:

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

Confirm the identity #

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

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 ""
grep -c BEGIN ~/.local/share/storj/identity/storagenode/ca.cert
grep -c BEGIN ~/.local/share/storj/identity/storagenode/identity.cert
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:

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: #

CLI Install GUI Install - Windows