Tip: For most Liquid users, a light wallet like Blockstream Green will be preferable to running a Liquid node.
A Liquid node allows you to send and receive assets on the Liquid Network, verify transactions, peg in Liquid Bitcoin (L-BTC), verify the L-BTC supply, and issue new assets.
To set up a Liquid node, you'll need to download Elements Core—the Liquid Network is built upon the Elements sidechain platform. Elements Core connects to the Liquid Network by default.
You will need a desktop computer with at least 4GB of hard disk space available to complete the installation.
Note: This guide is designed for beginners wanting to set up a Liquid node as fast as possible. Developers and other advanced users should instead see the advanced node setup guide in our technical documentation.
Install Your Liquid Node
1.
Download the latest installer for Elements Core from the Elements Core release page.
| macOS | elements-<version>-osx-unsigned.dmg |
| Windows | elements-<version>-win64-setup-unsigned.exe |
| Ubuntu | elements-<version>-x86_64-linux-gnu.tar.gz |
| Raspberry Pi | elements-<version>-arm-linux-gnueabihf.tar.gz |
Note: The guide below is for Liquid node users on macOS only. However, the process is very similar for Linux and Windows, so most users should be able to follow along.
2.
Double-click the downloaded .dmg file and drag the Elements Core application into the Applications folder.
3.
Open Elements Core.
The first time you run the application, you may be prompted with a window notifying you that: macOS cannot verify the developer of Elements Core. Click Open.
If there is no Open option, click Cancel. Then open System Preferences > Security & Privacy. Click Open Anyway next to the notification that “Elements Core was blocked from use because it is not from an identified developer”.
4.
When you run Elements Core for the first time, the application will ask for the data directory you want to use to store the Liquid blockchain data. Click OK to accept the default data directory.
If you have not installed a Bitcoin node on your machine or your Bitcoin node is currently not running, an error message will appear to notify you that Elements Core “is set to verify peg-ins but cannot get a valid response from the mainchain daemon”.
The error appears because Elements Core is configured to validate peg-ins to the Liquid Network, which requires the application to connect to a Bitcoin node on the same device. Because Elements Core cannot locate your Bitcoin node, the application cannot find the mainchain data and is therefore unable to validate peg-ins to the Liquid Network.
If you see the error message:
Click OK to close the window. Elements Core will now start downloading the Liquid blockchain. The application will run normally, but without peg-in validation enabled.
Warning: Most features in Elements Core do not require you to run a Bitcoin node. However, if peg-in validation on your Liquid node is disabled, any peg-ins you initiate using your node will be insecure. If you plan on initiating peg-ins run both a Bitcoin node and a Liquid node and enable peg-in validation.
If you do not see an error message:
Elements Core has successfully located your Bitcoin node and will immediately start its initial Liquid blockchain synchronization. Once Elements Core has downloaded the Liquid blockchain, your Liquid node can be used to send and receive Liquid assets, issue new assets, and peg in Liquid Bitcoin.