Frequently Asked Questions

How do I change change my parameters, such as payout address, allotted storage space, and bandwidth?

1. Stop and remove the running Storage Node Docker container (CLI) or stop the service (GUI Windows):

CLI Install
GUI Windows Install
docker stop -t 300 storagenode
docker rm storagenode
Elevated Powershell
Stop-Service "Storage Node"

Or click the "Stop" button in the Windows Services applet on "Storage Node" service

2. Start your storage node again by running the following command after editing WALLET, EMAIL, ADDRESS, BANDWIDTH, STORAGE, <identity-dir>, and <storage-dir>:

CLI Windows
CLI Non-ARM based platforms
CLI ARM-based platforms
GUI Windows Install
docker run -d --restart unless-stopped -p 28967:28967 -e WALLET="0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" -e EMAIL="user@example.com" -e ADDRESS="domain.ddns.net:28967" -e BANDWIDTH="20TB" -e STORAGE="2TB" --mount type=bind,source="<identity-dir>",destination=/app/identity --mount type=bind,source="<storage-dir>",destination=/app/config --name storagenode storjlabs/storagenode:alpha
docker run -d --restart unless-stopped -p 28967:28967 \
-e WALLET="0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-e EMAIL="user@example.com" \
-e ADDRESS="domain.ddns.net:28967" \
-e BANDWIDTH="20TB" \
-e STORAGE="2TB" \
--mount type=bind,source="<identity-dir>",destination=/app/identity \
--mount type=bind,source="<storage-dir>",destination=/app/config \
--name storagenode storjlabs/storagenode:alpha
docker run -d --restart unless-stopped -p 28967:28967 \
-e WALLET="0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-e EMAIL="user@example.com" \
-e ADDRESS="domain.ddns.net:28967" \
-e BANDWIDTH="20TB" \
-e STORAGE="2TB" \
--mount type=bind,source="<identity-dir>",destination=/app/identity \
--mount type=bind,source="<storage-dir>",destination=/app/config \
--name storagenode storjlabs/storagenode:arm

Open the config file "%ProgramFiles%\Storj\Storage Node\config.yaml" with a text editor (we recommend to use a Notepad++) and modify needed parameters. Save the configuration file and restart the Storage Node service.

Or in the elevated Powershell:

Elevated Powershell
Restart-Service "Storage Node"

How do I allow my node to focus on a smaller or larger maximum number of concurrent uploads?

Slower nodes like Raspberry Pi3 for example, may have difficulties getting any data. In previous releases (up to 0.14.3) they were accepting too many concurrent uploads but were unable to finish them in time. In the new releases after 0.14.3, we now have a new configuration option available to fine-tune the number of concurrent uploads. If your node was already previously running, first stop it.

Locate the node´s config.yaml file for editing:

CLI Install
GUI Windows Install

The configuration file is located in the storage location you indicated for storagenode's data

The configuration file is located in "$env:ProgramFiles/Storj/Storage Node/config.yaml" (PowerShell) or "%PROGRAMFILES%\Storj\Storage Node\config.yaml" (cmd.exe or Explorer)

Please edit your config.yaml file to add the line with the maximum concurrency setting:

CLI Install
GUI Windows Install
docker stop -t 300 storagenode

and then please edit your config.yaml file (on Windows use Notepad++, not Notepad, on MacOS use TextEdit, not Notes) to add the following line at the end of the file:

storage2.max-concurrent-requests: 7

In elevated Powershell, first stop the service:

Elevated PowerShell
Stop-Service "Storage Node"

Then edit your config.yaml file, using Notepad++, not Notepad, to add the following line at the end of the file:

storage2.max-concurrent-requests: 7

Save the config.yaml file and then restart your node if it was already running before:

CLI Install
GUI Windows Install
docker restart -t 300 storagenode
Elevated PowerShell
Restart-Service "Storage Node"

Or click the "Restart" button in the Windows Services applet on "Storage Node" service

This will allow slow nodes to focus on a smaller number of uploads and finish them as fast as possible, while refusing the uploads it couldn't process anyway. You can adjust the number of requests - 7 is just an initial suggestion, but you can modify this number up or down and monitor the performance of your node until you find the right number of requests for your particular node which does not cause your node to be overwhelmed. Faster nodes will be able to function with a higher number of concurrent requests than slow nodes.

Many other storage nodes are working through this as well, see how they approach this.

How do I check my logs?

You can look at your logs to see if you have some errors indicating that something is not functioning properly:

CLI Install
GUI Windows Install
docker logs storagenode

Use this command if you just want to see the last 20 lines of the log:

docker logs --tail 20 storagenode

From PowerShell, to see the last 20 lines of the log:

cat "$env:ProgramFiles/Storj/Storage Node/storagenode.log" -Tail 20 -Wait

How do I redirect my logs to a file?

1. To redirect the logs to a file, stop your node:

CLI Install
GUI WIndows Install
docker stop -t 300 storagenode
Elevated Powershell
Stop-Sevice "Storage Node"

Or click the "Stop" button in the Windows Services applet on "Storage Node" service

2. Then edit your config.yaml (you can use nano or vi editor for Linux/MacOS or Notepad++ for Windows) to add (or change) the log location:

CLI Install
GUI Windows Install
log.output: "/app/config/node.log"
log.output: winfile:///X:\Storagenode\node.log

3. Start your node again:

CLI Install
GUI Windows Install
docker start storagenode
Elevated Powershell
Start-Service "Storage Node"

Or click the "Start" button in the Windows Services applet on "Storage Node" service

When you use this option, docker logs commands no longer show your node log. Use the file instead.

How do I shutdown my node for maintenance on my system?

If you need to shutdown the Storage Node for maintenance on your system, run:

CLI Install
GUI Windows Install
docker stop -t 300 storagenode
Elevated Powershell
Stop-Service "Storage Node"

Or click the "Stop" button in the Windows Services applet on "Storage Node" service

After you finished your maintenance, restart the node with:

CLI Install
GUI Windows Install
docker start storagenode
Elevated Powershell
Start-Service "Storage Node"

Or click the "Start" button in the Windows Services applet on "Storage Node" service

How do I migrate my Node to a new Drive or Computer?

If you want to migrate your node to a new drive or computer, you need to migrate both the contents of your storage folder and your identity folder to the new location and change the corresponding paths for both storage and identity folders --mount parameters in your docker run storagenode command. If you are migrating to a GUI Windows Install, please see step 9 of the GUI Windows Install Instructions.

How do I estimating my Payouts per Satellite?

If you would like to estimate how much you can expect to get paid for running your node during a given month, please follow the instructions here. Please note that this script will not give you exact values, your actual payout may be slightly different from what you calculated for each satellite. Also note that the script will estimate what will be the payout you will receive depending on how long you already have been running the node on a satellite, taking into account the amount withheld in the initial months which is not immediately paid out to the node operator. Please see more details about held amounts in this blog post.

What other commands can I run?

Run help to see other commands:

CLI Install
GUI Windows Install
docker exec -it storagenode /app/storagenode help
Powershell
"$env:ProgramFiles\Storj\Storage Node\storagenode.exe" --help

Run the following to execute other commands:

CLI Install
GUI Windows Install
docker exec -it storagenode /app/storagenode <<command>>
Powershell
"$env:ProgramFiles\Storj\Storage Node\storagenode.exe" <<command>>

What if I'm using a Remote Connection?

If you must use a remote connection, due to the length of time it takes for some of the steps, it is highly recommended to run them inside a virtual console like TMUX or SCREEN.

It is recommended to perform the next steps local to the machine, and not via a remote connection.

What if I'm using Windows or Mac OS?

Your node may require extra monitoring. You may have to frequently restart Docker from the Docker desktop application when your Last Contact shown in the dashboard gets larger than a few seconds.

This is your Storage Node Dashboard. The Last Contact time may lag on Windows and Mac, requiring you restart your node.