Skip to main content

Linux Configuration

Running the node via service file​

To run your node via systemd, create the service file and open it:

nano /lib/systemd/system/ceremonyclient.service

Paste the below code (If your working directory is different from "root" than edit the code accordingly):

[Unit]
Description=Ceremony Client Go App Service
StartLimitIntervalSec=0
StartLimitBurst=0

[Service]
Type=simple
Restart=always
RestartSec=5s
WorkingDirectory=/root/ceremonyclient/node
ExecStart=bash -e /root/ceremonyclient/node/release_autorun.sh
KillSignal=SIGINT
RestartKillSignal=SIGINT
FinalKillSignal=SIGKILL
TimeoutStopSec=30s

[Install]
WantedBy=multi-user.target

warning

The above setup allows easy management and auto-updates of the node by executing the release_autorun.sh, but won't work to stop the node gracefully (SIGINT), which could cause your node to receive penalties. The reason is that the SIGINT command is not trapped by the release_autorun.sh, which is the one running your node process.
A better setup would be to change the ExecStart line of the service file and use the correct node binary file name there. If you do this, you will have to manually update the node as well as edit your service file with the new binary name.

Save the file, exit and enable the service:

sudo systemctl daemon-reload && sudo systemctl enable ceremonyclient

Start the node

service ceremonyclient start

Now the node will start automaytically after each reboot.

Useful node commands​

Service commands​

The below commands will work when running a node via service file

Start service

service ceremonyclient start

Stop service

service ceremonyclient stop

Restart service

service ceremonyclient restart

Node log

sudo journalctl -u ceremonyclient.service -f --no-hostname -o cat

Node version

journalctl -u ceremonyclient -r --no-hostname  -n 1 -g "Quilibrium Node" -o cat

Service status

service ceremonyclient status

General Linux commands​

Change the NODE_DIR variable according to your needs

Get your peerID

NODE_DIR="$HOME/ceremonyclient/node"
NODE_BINARY=$(find "$NODE_DIR" -type f -executable -name "node-*" ! -name "*.dgst*" ! -name "*.sig*" | sort -V | tail -n 1 | xargs basename)
cd "$HOME/ceremonyclient/node" && ./$NODE_BINARY -peer-id


See node info
PeerID - Version - Max frame - Balance
This can give an error on nodes that are not fully sync, but you will still see your peerID

NODE_DIR="$HOME/ceremonyclient/node"
NODE_BINARY=$(find "$NODE_DIR" -type f -executable -name "node-*" ! -name "*.dgst*" ! -name "*.sig*" | sort -V | tail -n 1 | xargs basename)
cd "$HOME/ceremonyclient/node" && ./$NODE_BINARY -node-info


Check balance

NODE_DIR="$HOME/ceremonyclient/node"
NODE_BINARY=$(find "$NODE_DIR" -type f -executable -name "node-*" ! -name "*.dgst*" ! -name "*.sig*" | sort -V | tail -n 1 | xargs basename)
cd "$HOME/ceremonyclient/node" && ./$NODE_BINARY -balance