Skip to main content

Installing and running BPX full node on Debian / Ubuntu

  1. Check latest versions of BPX Execution Client and Beacon Client. Log in as root. Download both DEB packages by following commands. Replace X.X.X to latest versions tags.
wget https://github.com/bpx-network/bpx-execution-client/releases/download/X.X.X/bpx-execution-client_X.X.X-stable+stable_amd64.deb
wget https://github.com/bpx-network/bpx-beacon-client/releases/download/X.X.X/bpx-beacon-client-cli_X.X.X-1_amd64.deb

2. Install execution client and beacon client. Replace X.X.X to latest versions tags.

dpkg -i bpx-execution-client_X.X.X-stable+stable_amd64.deb bpx-beacon-client-cli_X.X.X-1_amd64.deb

VirtualBox_Debian_09_06_2023_11_16_04.png

3. Create new user for BPX services

adduser bpxv3

Create any password. You can skip entering additional information about the user by pressing Enter each time. Answer "Y" when asked if the information is correct.

VirtualBox_Debian_09_06_2023_11_20_24.png

4. Switch to the newly created account

su - bpxv3

5. Initialize Beacon Client configuration

bpx init

VirtualBox_Debian_09_06_2023_11_24_02.png

6. Press Control + D to log out and return to the root console.

7. Create the execution client service descriptor file using for example nano editor

nano /etc/systemd/system/bpx-execution.service

Insert the following file content:

[Unit]
Description=BPX Execution Client

[Service]
Type=simple
User=bpxv3
ExecStart=bpx-geth --syncmode snap --http
Restart=always

[Install]
WantedBy=multi-user.target

Save the file by pressing Control + O and close the editor with Control + X.

8. Create the beacon client service descriptor file:

nano /etc/systemd/system/bpx-beacon.service

Insert the following file content:

[Unit]
Description=BPX Beacon Client

[Service]
Type=forking
User=bpxv3
ExecStart=bpx start node
ExecStop=bpx stop -d all
Restart=always

[Install]
WantedBy=multi-user.target

Save the file and close the editor.

9. Refresh startup services configuration

systemctl daemon-reload

10. Activate automatic startup of BPX services

systemctl enable bpx-execution
systemctl enable bpx-beacon

11. Launch both services

systemctl start bpx-execution
systemctl start bpx-beacon

VirtualBox_Debian_09_06_2023_11_42_06.png

12. Your full node is already working and configured to automatically start on system boot. Use the commands below to watch the initial sync status (it will refresh every 10 seconds).

su - bpxv3
watch -n 10 bpx show -s

VirtualBox_Debian_09_06_2023_11_51_29.png

13. After a few hours or days, the initial sync should complete.

VirtualBox_Debian_09_06_2023_23_22_40.png