Skip to content

Fractal Bitcoin Node

Running

You can run fractal bitcoin node in many ways, here are some examples:

Docker

  1. make sure you have docker installed, see official document for more details.
  2. create a service directory
Terminal window
mkdir -p /opt/fractald
cd /opt/fractald
  1. create a docker-compose.yml file
services:
fractald:
image: fractalbitcoin/fractal:v0.2.1
entrypoint: ["bitcoind", "-datadir=/data/"]
healthcheck:
test: ["CMD", "bitcoin-cli", "-datadir=/data/", "getblockchaininfo"]
volumes:
- ./data:/data
  1. start the service and check the status
Terminal window
docker compose up -d
docker compose ps
docker compose logs -f fractald

Systemd

  1. download the release binary from here
Terminal window
wget https://github.com/fractal-bitcoin/fractald-release/releases/download/v0.2.1/fractald-0.2.1-x86_64-linux-gnu.tar.gz
tar zxvf fractald-0.2.1-x86_64-linux-gnu.tar.gz
mv fractald-0.2.1-x86_64-linux-gnu /opt/fractald
  1. create data directory and config file
Terminal window
cd /opt/fractald
mkdir data
cp ./bitcoin.conf ./data/bitcoin.conf
  1. edit the config file
/opt/fractald/data/bitcoin.conf
txindex=1
rpcbind=0.0.0.0
rpcallowip=192.168.1.0/24
rpcport=8332
rpcuser=fractal
rpcpassword=<choose a strong password>
  1. create a systemd service
Terminal window
vim /etc/systemd/system/fractald.service
[Unit]
Description=Fractald Daemon
After=network.target
[Service]
User=root
Group=root
WorkingDirectory=/opt/fractald
# start command
ExecStart=/opt/fractald/bin/bitcoind --datadir=/opt/fractald/data/
# stop command (optional)
ExecStop=/opt/fractald/bin/bitcoin-cli stop
Restart=always
RestartSec=10
# resource limit (optional, adjust according to needs)
LimitNOFILE=4096
[Install]
WantedBy=multi-user.target
  1. start and enable the service
Terminal window
systemctl daemon-reload
systemctl start fractald
systemctl enable fractald
  1. check the status and logs
Terminal window
systemctl status fractald
journalctl -u fractald -f

Configuration

Security