Skip to content

nbobtc/bitcoind-cookbook

Repository files navigation

bitcoind-cookbook

This cookbook will install a Bitcoin node. You can also enable or disable the wallet ability. By disabling the wallet you will have a seed node that can be used to connect to.

This is a cookbook that I use to setup seed nodes and other services that require a bitcoin node.

Supported Platforms

  • ubuntu 14.04

Attributes

Key Type Description Default
['bitcoind']['install_via'] enum `package` or `source` I recommend you use `package`. package
['bitcoind']['bin'] string Location of executable /usr/bin/bitcoind
['bitcoind']['user'] string bitcoin
['bitcoind']['group'] string bitcoin
['bitcoind']['piddir'] string /var/run/bitcoind
['bitcoind']['pidfile'] string /var/run/bitcoind/bitcoind.pid
['bitcoind']['datadir'] string /var/lib/bitcoind
['bitcoind']['wallet']['enabled'] boolean true
['bitcoind']['config']['file'] string /etc/bitcoin/bitcoin.conf
['bitcoind']['config']['options'] hash Configures the options that are put into the bitcoin.conf file. {}

Usage

Create a testnet node:

{
    "bitcoind": {
        "config": {
            "options": {
                "testnet": 1,
                "rpcuser": "insecure_username",
                "rpcpassword": "please_rob_me",
                "rpcallowip": ["127.0.0.1", "192.168.1.1"],
                "rpcport": 18332
            }
        }
    }
}

You can see various options that can go into the configuration file at https://en.bitcoin.it/wiki/Running_Bitcoin#Sample_Bitcoin.conf

bitcoind::default

Include bitcoind in your node's run_list:

{
  "run_list": [
    "recipe[bitcoind]"
  ]
}

License and Authors

Author:: Joshua Estes ([email protected])