This is an old revision of the document!

How to run a Bootstrap Node


Assuming that Toxcore has already been built, cd to


and run


Change ADDRESS, PORT, and KEY to that of any active DHT node.

Daemonized version

Toxcore also has a daemonized version of the bootstrap node code wish can be used on SystemV init or systemd init systems.

You first need to configure tox to build the bootstrap node executable. Run the configure script with


as an argument. The tox_bootstrap_daemon executable will be placed in


, so grab a copy from there and place it where you want the daemon to run from.

Configuring Daemon script

Note that the following instructions might be out of date and it's preferable to read the file maintained by the daemon developer.

Next we need to configure


Set the NAME, USER, CFG, PIDFILE and SCRIPTNAME arguments as per your installation.

NAME Name of the executable (default is the tox_bootstrap_daemon)
USER Name of the user the daemon will run as (e.g. tox)
CFG Location of configuration file
PIDFILE Where to create the pid file for the daemon
SCRIPTNAME Path to the (used to change name of the script)

There are a few other options generated by a combination of these items, and you may wish to customize them for your needs.

Configuring the daemon itself

Now we need to configure the conf file that the daemon uses, located in


At minimum you need to set the keys_file_path, pid_file_path and add some bootstrap nodes.

keys_file_path The path to your keys file that will store the keypair for your daemon
pid_file_path The path to the pid file and should be set based on what you chose for PIDFILE earlier

To get the bootstrap nodes, you can either grab them from here or use an updater script - some options here: issue

Generate the service

Place the daemon script in


and rebuild the service list.

Finally, start the service!


The daemon outputs to syslog, so if you have the appropriate permissions:

tail -f /var/log/syslog | grep "tox_bootstrap_daemon"

will give you a nice debug output (NB: if you change the name edit the grep appropriately)