Skip to main content

How to install and run BPX full node on Windows

  1. Download the Execution Client and Beacon Client latest releases EXE installers.

VirtualBox_Win10_07_06_2023_15_18_56.png

VirtualBox_Win10_07_06_2023_15_18_19.png

2. Go to your Downloads folder. There should be two installers there. Run the execution client installer first.

VirtualBox_Win10_07_06_2023_15_21_06.png

3. Different warnings may appear depending on the Windows version. In such cases, select "More info", "Run anyway" and "Yes".

VirtualBox_Win10_07_06_2023_15_22_29.png

VirtualBox_Win10_07_06_2023_15_22_58.png

VirtualBox_Win10_07_06_2023_15_24_22.png

4. Accept the license. Go through all installer steps by clicking "Next" and "Install". When the installation process is finished, close the installer.

VirtualBox_Win10_07_06_2023_15_27_05.png

VirtualBox_Win10_07_06_2023_15_28_06.png

5. A shortcut to BPX Execution Client will appear in the Start Menu. Run it.

Never launch the Execution Client in any other way, especially by double-clicking the bpx-geth.exe file from C:\Program Files. This will switch the synchronization mode which cannot be reverted in any other way than deleting all files from C:\Users\username\.bpx\execution. BPX Execution Client requires additional command-line parameters which are already configured in the Start Menu shortcut. If you are an advanced user, you can run the execution client by this command:

bpx-geth.exe --syncmode full --http --authrpc.addr localhost --authrpc.port 8551 --authrpc.vhosts localhost

but never just bpx-geth.exe without any arguments.

VirtualBox_Win10_07_06_2023_15_30_15.png

6. Allow the Windows firewall to open the execution client port. Execution client will be started. You should see its console output window.

VirtualBox_Win10_07_06_2023_15_35_47.png

VirtualBox_Win10_07_06_2023_15_35_59.png

7. Now start the Beacon Client installer. Confirm pop-up warnings as before.

VirtualBox_Win10_07_06_2023_15_39_55.png

8. Accept the license, go through the next installation steps.

VirtualBox_Win10_07_06_2023_15_41_00.png

9. When the installation is finished, click the "Get Started" button.

VirtualBox_Win10_07_06_2023_15_41_44.png

10. Agree to open the beacon client port as before.

VirtualBox_Win10_07_06_2023_15_42_57.png

11. Beacon Client GUI will be launched. Select Node mode.

VirtualBox_Win10_07_06_2023_15_56_13.png

12. At this point, both clients will start synchronizing with the network. This may take many hours or days.

VirtualBox_Win10_07_06_2023_15_57_39.png

VirtualBox_Win10_07_06_2023_15_58_58.png

13. When synchronization is finished, your full node is ready to work. You'll know it by the green "Synced" status.

VirtualBox_Win10_08_06_2023_01_46_36.png

14. When you need to stop your full node, it's highly recommended to close the beacon client first, then the execution client. To start it again, run the execution client first, then the beacon client.

Never stop the Execution Client by closing the console window. Use the Control + C shortcut and wait for the client to close itself. If your database becomes corrupted due to improper shutdown, you have to delete all files from  C:\Users\username\.bpx\execution and wait until the long-running synchronization ends.

VirtualBox_Win10_08_06_2023_10_34_18.png