If your Windows doesn't support WSL2 we recommend to install version 22.214.171.124. We do not recommend using later versions with Hyper-V as a lot of bugs have been reported.
3. The difference between the Windows GUI and the Docker CLI is where each system stores the data. The Windows GUI version stores data in the path specified in the
storage.path parameter of the configuration file
"%ProgramFiles%\Storj\Storage Node\config.yaml", while the Docker version stores data in the subfolder called
storage, which is automatically (silently) added to the specified path through the
The same applies for the
orders folder. In the Windows GUI version it's stored in the installation location (
"%ProgramFiles%\Storj\Storage Node\orders" by default), the docker version stores orders alongside with data in the data location.
For example, if the storage folder specified in the Windows GUI is
D:\STORJ, then for the Docker version you should move the content of the
D:\STORJ folder to the subfolder
D:\STORJ\storage, the orders should be moved from the
"%ProgramFiles%\Storj\Storage Node\orders" to the
The same applies for Linux/MacOS systems. How do we accomplish that?
We will use the
D:\STORJ path of the source Windows system as an example. The destination path depends on OS:
In Windows, we will use the same folder
D:\STORJ and PowerShell as a terminal.
We will assume that your Windows user is called
user and it has full access to the
If you are moving the identity and data to the new Windows CLI host, you need to share the destination folder on that host and follow the guide How to migrate the Windows GUI node from one physical location to another?
The configuration steps are different depending on the destination OS.
If your source and destination OSes are both Windows, you can use the integrated
robocopy command-line utility to copy your files across the network or local system: How to migrate the Windows GUI node from one physical location to another?
If your source and destination is the same Windows, stop and disable storagenode service to avoid disqualification. Execute in the elevated PowerShell:
And rename folders to use with docker. Please replace
D:\STORJ with your actual path (PowerShell):
You can use this guide to migrate the identity, orders and data to a different device: How do I migrate my node to a new device?
We will assume that your identity is placed in the default location, i.e.
%APPDATA%\Storj\Identity\storagenodeand you used the default setup location, i.e. orders are located there:
"C:\Program Files\Storj\Storage Node\orders"
The storage data has already been migrated in the previous step.
Now move orders to the data location:
When the data migration is completed, you should remove the storagenode Windows GUI version from the source Windows.
If you did not remove the Windows GUI storagenode instance, it could be automatically started by
storagenode-updater service resulting in two copies of the same node in the network. It will be disqualified within a hour because it will not have all pieces since after the migration.
Now you can run the storagenode container following this guide: Storage Node.