Skip to main content

Installing the timelord on Debian / Ubuntu

1. To run a timelord, you need a fully synchronized full node. If you don’t have one, follow all the steps of this tutorial.

2. The timelord software is not included in the official binary .deb or .rpm releases. You need to build it from the source code. Log in as root and install the Git client first.

apt-get install git

3. The timelord installer script requires root access to install certain dependencies from APT repositories. Add the BPX Chain services user to the sudoers with the following command:

usermod -a -G sudo bpxchain

4. Switch to the BPX Chain services user account:

su - bpxchain

4. Clone the BPX Beacon Client git repository:

git clone https://github.com/bpx-network/bpx-beacon-client

5. Install the Beacon Client from the source. This process may take several minutes.

cd bpx-beacon-client
. install.sh

6. Install the timelord module:

. install-timelord.sh

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

8. Create a configuration file for the timelord systemd service:

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

Insert the following file content:

[Unit]
Description=BPX Timelord

[Service]
Type=forking
User=bpxchain
WorkingDirectory=/home/bpxchain/bpx-beacon-client
ExecStart=bash -c ". activate && bpx start timelord-launcher-only timelord-only"
ExecStop=bash -c ". activate && bpx stop timelord-only timelord-launcher-only"
Restart=always

[Install]
WantedBy=multi-user.target

9. Reload the system services configuration.

systemctl daemon-reload

10. Enable automatic startup of the new service.

systemctl enable bpx-timelord

Regular Timelord

If you want to run a regular timelord used by BPX consensus algorithm for generating new blocks, simply start the timelord with the default configuration:

systemctl start bpx-timelord

Bluebox Timelord

To run the bluebox timelord, which compresses old blocks in the chain, you need to edit the configuration file:

nano /home/bpxchain/.bpxchain/beacon/config/config.yaml
  • In the timelord section, set bluebox_mode to True
  • In the beacon section, set send_uncompact_interval to recommended value of 300

Save the file and exit. Then start the timelord service:

systemctl start bpx-timelord
Back to top