# Run a Bitcoin Node

This guide is designed for setting up a Glittr node on testnet4 or a local network.

## Getting bitcoind executables 

Download or build `bitcoind` and `bitcoin-cli`

Make sure you are using at least version 28.x (testnet4 support).

#### Linux

* Download prebuilt executables: <https://bitcoincore.org/bin/bitcoin-core-28.0/bitcoin-28.0-x86_64-linux-gnu.tar.gz>
* Build from source: <https://github.com/bitcoin/bitcoin/blob/28.x/doc/build-unix.md>

After you obtain the executables, set your PATH environment variable to where the binaries are are (bitcoin-28.0/bin/ for prebuilt).

#### MacOS

* Install using brew <https://formulae.brew.sh/formula/bitcoin>
* Build from source: <https://github.com/bitcoin/bitcoin/blob/28.x/doc/build-osx.md>

After you build the executables by building from source, set your PATH environment variable to where the binaries are are (src/ usually). You may not need to do this if you installed using brew.

#### Windows

* Download prebuilt executables: <https://bitcoincore.org/bin/bitcoin-core-28.0/bitcoin-28.0-win64.zip>
* Build from source: <https://github.com/bitcoin/bitcoin/blob/28.x/doc/build-windows.md>

After you obtain the executables, set your PATH environment to where the binaries are are (bitcoin-28.0/bin/ for prebuilt).&#x20;

### Checking correct installation

To check that bitcoind is installed correctly, open a terminal and run bitcoind. To avoid syncing the entire blockchain (very long process), follow the instructions for testnet4 or local development below THE FIRST TIME YOU RUN bitcoind.

### Bitcoin Config for testnet4

Create a new directory \[mkdir], e.g. bitcointestnet4, and then create a new file bitcoin.conf

Copy the text below into bitcointestnet4/bitcoin.conf

note: rpcauth can be generated by using this script <https://github.com/bitcoin/bitcoin/blob/master/share/rpcauth/rpcauth.py>

```
testnet4=1

[testnet4]
rpcuser=root
rpcpassword=root
# generate using https://github.com/bitcoin/bitcoin/blob/master/share/rpcauth/rpcauth.py
rpcauth=rpcauth=root:98307881641a85ed72ac421b4997b8ce$206a7001fc977b92a67fd0bc9012765335eff452a2fde6a943d53f998a71256d

coinstatsindex=1
blockfilterindex=1
server=1
txindex=1
listen=1

maxconnections=100
datadir=/home/bitcoind/data
```

### Bitcoin Config for local development

Create a new directory \[mkdir], e.g. bitcoinlocal, and then create a new file bitcoin.conf

Copy the text below into bitcoinlocal/bitcoin.conf

```
[regtest]
regtest=1
dnsseed=0
rpcuser=user
rpcpassword=password
txindex=1
rpcallowip=127.0.0.1/0
rpcbind=127.0.0.1
fallbackfee=0.00001
datacarriersize=10000
maxburnamount=10000
```

### Running the bitcoin node

Open your terminal (or PowerShell if you are on Windows). Run bitcoind using the datadir parameter and then add the network `-testnet4`or `-regtest`.

```bash
$ bitcoind -datadir=<bitcoin-data-location> -testnet4
```

e.g.

```bash
$ bitcoind -datadir=./bitcointestnet4/ -testnet4
```

```bash
$ bitcoind -datadir=./bitcoinlocal/ -regtest
```