Here is a step by step guide on how to build Conflux from the source code and get a node running.
Install Build Dependencies
Conflux requires Rust 1.47.0,
sqlite to build.
We recommend installing Rust through rustup. If you don't already have
clang, you can install them like this:
Other dependencies including
cmake (version >= 3.1) and
sqlite (version >= 3.8.3) can be installed with:
- Ubuntu 18.04:
- CentOS 7 / RHEL:
You might need to install
brew if you need to use it to install
clang comes with Xcode command line tools, and can also be installed with homebrew:
Make sure you have Visual Studio 2015 with C++ support installed. Next, download and run the
rustup installer from this link, start
VS2015 x64 Native Tools Command Prompt, and use the following command to install and set up the
clang can be installed with LLVM. Pre-built binaries can be downloaded from Download LLVM. Make sure to add LLVM to the system PATH as instructed.
Make sure that these binaries are in your
PATH (the instruction will be shown after installing
rustup). After that, you should be able to build Conflux from source.
Build from Source Code
After installing the dependencies mentioned above, now you can clone our repository and start building the executable binary:
This produces an executable in the
Note, when compiling a crate and you receive errors, it's in most cases your outdated version of Rust, or some of your crates have to be recompiled. Cleaning the repository will most likely solve the issue if you are on the latest stable version of Rust, try:
To start running a Conflux full node, you can follow the instructions at Running Conflux Full Node.
Install Test Dependencies
We have a test framework written in Python3 (version>=3.6). Required packages can be installed by running
solc is also required, and be installed as follows:
You can follow the detailed instructions at Installing the Solidity Compiler.
Note that latest solidity compiler may be incompatible with Conflux and may cause the integration test to fail. If you encounter such problem, please install solidity compiler version 0.5.2.
To run tests, you can build the source code first and follow the instructions at Running Test.
Download compiled node binary
If you don't want to build the node from the source code, you can directly download the pre-compiled binary from github release page. We provide the binaries for Windows, Linux, and OSX. There are two release lines: mainnet and testnet (with suffix
testnet). If you want to run a mainnet node, you should choose
Conflux vx.x.x, and if you want to run a testnet node, please choose
Conflux vx.x.x-testnet. mainnet release uses config file
tethys.toml, while testnet release uses config file
testnet.toml, and the values of the keys
chain_id of the two config files are different.
After downloading and unzipping the release file, you can run the node with