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

mkdir -p /opt/fractald
cd /opt/fractald

3. 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

4. start the service and check the status

docker compose up -d
docker compose ps
docker compose logs -f fractald

Systemd

1. download the release binary from here

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

2. create data directory and config file

cd /opt/fractald
mkdir data
cp ./bitcoin.conf ./data/bitcoin.conf

3. 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>

4. create a systemd service

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

5. start and enable the service

systemctl daemon-reload
systemctl start fractald
systemctl enable fractald

6. check the status and logs

systemctl status fractald
journalctl -u fractald -f

Configuration

Security