├── fractald-docker ├── cli.sh └── docker-compose.yaml ├── 2025-07-13-prune-mode.md └── README.md /fractald-docker/cli.sh: -------------------------------------------------------------------------------- 1 | docker-compose exec bitcoind bitcoin-cli -datadir=/data "$@" -------------------------------------------------------------------------------- /fractald-docker/docker-compose.yaml: -------------------------------------------------------------------------------- 1 | version: "3" 2 | services: 3 | bitcoind: 4 | image: fractalbitcoin/fractal:v0.2.9rc2 5 | entrypoint: ["bitcoind", "-datadir=/data/"] 6 | healthcheck: 7 | test: ["CMD", "bitcoin-cli", "-datadir=/data/", "getblockchaininfo"] 8 | volumes: 9 | - ./data:/data 10 | -------------------------------------------------------------------------------- /2025-07-13-prune-mode.md: -------------------------------------------------------------------------------- 1 | 2 | # 2025.07 Fractal Prune Mode Explained 3 | 4 | ## 💡 Recommended Prune Configuration 5 | 6 | To optimize disk usage, we recommend keeping ~30GB of recent blocks. You can do this by updating your `bitcoin.conf` as follows: 7 | 8 | ``` 9 | prune=30000 # Retains ~30GB of recent blocks 10 | txindex=0 # Required when pruning (default is 0) 11 | ``` 12 | 13 | With this configuration, the total disk usage of prune mode is expected to be around 300GB, mainly used by: 14 | 15 | ``` 16 | 30G data/blocks 17 | 191G data/chainstate 18 | ``` 19 | 20 | ## ⚠️ Important Notes on Pruning Existing Nodes 21 | 22 | If you're enabling prune mode from an existing full node, note that: 23 | 24 | A legacy `txindex` folder (~153GB) will remain under `data/indexes/txindex`. 25 | 26 | - ✅ It is safe to delete this folder in prune mode 27 | - 🧹 Manual cleanup required 28 | 29 | This step helps reclaim significant disk space if you’re converting a full node to a pruned one. 30 | 31 | ## Fractal node v0.2.3 of prune mode enhancement 32 | 33 | - 💾 Lowered minimum pruning height: 34 | Reduced from 100,000 to 10,000 — allowing nodes to prune more data and save additional disk space 35 | 36 | 👉 [View full release notes](https://github.com/fractal-bitcoin/fractald-release/releases/tag/v0.2.3) 37 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Fractal Bitcoin Overview 2 | 3 | **Website:** [Fractal Bitcoin](https://fractalbitcoin.io) 4 | 5 | ## What is Fractal Bitcoin? 6 | 7 | Fractal Bitcoin is the only Bitcoin scaling solution that uses the Bitcoin Core code itself to recursively scale unlimited layers on top of the world’s most-secure and -held blockchain. 8 | 9 | It is the first instance of a virtualization methodology applied to Bitcoin in the world. Fractal gradually extends the Bitcoin blockchain into a scalable computing system without breaking consistency with the Bitcoin main chain. 10 | 11 | With strong tooling and support, building on Fractal is straightforward. 12 | 13 | ## Getting Started 14 | 15 | ### System Requirements 16 | 17 | | Node Type | CPU | RAM | Storage (Mainnet) | Storage (Testnet) | 18 | | ----------- | ------- | ---- | ------------------- | ----------------- | 19 | | Full Node | 2 cores | 8 GB | 2 TB | 300 GB | 20 | | Mining Node | 2 cores | 4 GB | 300 GB (prune mode) | 100 GB | 21 | 22 | - For more details of Prune Mode, please check: [2025.07 Fractal Prune Mode Explained](./2025-07-13-prune-mode.md) 23 | 24 | ### Installation Options 25 | 26 | **1. Linux Binary Installation** 27 | 28 | ``` 29 | # Download and extract release 30 | wget https://github.com/fractal-bitcoin/fractald-release/releases/download/v0.2.9rc2/fractald-0.2.9rc2-x86_64-linux-gnu.tar.gz 31 | tar -zxvf fractald-0.2.9rc2-x86_64-linux-gnu.tar.gz 32 | 33 | # Run the daemon 34 | cd fractald-0.2.9rc2-x86_64-linux-gnu 35 | mkdir data 36 | ./bin/bitcoind -datadir=./data/ 37 | ``` 38 | 39 | **2. Docker Installation** 40 | 41 | ``` 42 | git clone https://github.com/fractal-bitcoin/fractald-release.git 43 | cd fractald-release/fractald-docker 44 | docker-compose up -d 45 | ``` 46 | 47 | ## Configuration 48 | 49 | **Testnet Setup** 50 | 51 | Add to bitcoin.conf: 52 | 53 | ``` 54 | testnet=1 55 | [testnet] 56 | ``` 57 | 58 | **Pruning (Space Saving)** 59 | 60 | ``` 61 | prune=10000 # Keeps ~10GB of blocks 62 | # Pruning activates after block 10,000 since v0.2.3 (was 100,000 before). 63 | ``` 64 | 65 | ## Build Fractal Bitcoin 66 | 67 | The following are developer notes on how to build Bitcoin Core on your native platform. They are not complete guides, but include notes on the necessary libraries, compile flags, etc. 68 | 69 | - [Dependencies](https://github.com/fractal-bitcoin/fractal/blob/main/doc/dependencies.md) 70 | - [macOS Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-osx.md) 71 | - [Unix Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-unix.md) 72 | - [Windows Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-windows.md) 73 | - [FreeBSD Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-freebsd.md) 74 | - [OpenBSD Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-openbsd.md) 75 | - [NetBSD Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-netbsd.md) 76 | - [Android Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-android.md) 77 | --------------------------------------------------------------------------------