Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lukechilds/docker-bitcoind
Run a full Bitcoin node with one command
https://github.com/lukechilds/docker-bitcoind
bitcoin bitcoin-core bitcoin-node bitcoind container cryptocurrencies cryptocurrency docker
Last synced: 4 months ago
JSON representation
Run a full Bitcoin node with one command
- Host: GitHub
- URL: https://github.com/lukechilds/docker-bitcoind
- Owner: lukechilds
- License: mit
- Created: 2019-11-08T04:43:41.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-22T12:22:58.000Z (about 2 years ago)
- Last Synced: 2024-10-20T14:34:32.640Z (4 months ago)
- Topics: bitcoin, bitcoin-core, bitcoin-node, bitcoind, container, cryptocurrencies, cryptocurrency, docker
- Language: Dockerfile
- Homepage:
- Size: 58.6 KB
- Stars: 7
- Watchers: 4
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# docker-bitcoind
[](https://hub.docker.com/r/lukechilds/bitcoind/)
[](https://hub.docker.com/r/lukechilds/bitcoind/tags?name=latest)
[](https://github.com/sponsors/lukechilds)
[](https://lu.ke/tip/bitcoin)
[](https://lu.ke/tip/lightning)
> Run a full Bitcoin node with one command
A Docker configuration with sane defaults for running a full Bitcoin node.
## Usage
```
docker run --name bitcoind -v $HOME/.bitcoin:/data/.bitcoin -p 8333:8333 lukechilds/bitcoind
```
### JSON-RPC
To query `bitcoind`, execute `bitcoin-cli` from within the container:
```
docker exec -it bitcoind bitcoin-cli getnetworkinfo
```
To access JSON-RPC from other services you'll also need to expose port 8332. You probably only want this available to localhost:
```
docker run --name bitcoind -v $HOME/.bitcoin:/data/.bitcoin \
-p 8333:8333 \
-p 127.0.0.1:8332:8332 \
lukechilds/bitcoind
```
You could now query JSON-RPC via cURL like so:
```
curl --data '{"jsonrpc":"1.0","id":"curltext","method":"getnetworkinfo"}' \
http://$(cat $HOME/.bitcoin/.cookie)@127.0.0.1:8332
```
### CLI Arguments
All CLI arguments are passed directly through to bitcoind.
You can use this to configure via CLI args without a config file:
```
docker run --name bitcoind -v $HOME/.bitcoin:/data/.bitcoin \
-p 8333:8333 \
-p 127.0.0.1:8332:8332 \
lukechilds/bitcoind -rpcuser=jonsnow -rpcpassword=ikn0wnothin
```
Or just use the container like a bitcoind binary:
```
$ docker run lukechilds/bitcoind -version
Bitcoin Core Daemon version v0.18.1
Copyright (C) 2009-2019 The Bitcoin Core developers
Please contribute if you find Bitcoin Core useful. Visit
for further information about the software.
The source code is available from .
This is experimental software.
Distributed under the MIT software license, see the accompanying file COPYING
or
This product includes software developed by the OpenSSL Project for use in the
OpenSSL Toolkit and cryptographic software written by
Eric Young and UPnP software written by Thomas Bernard.
```
### Version
Run a specific version of bitcoind if you want.
```
docker run --name bitcoind -v $HOME/.bitcoin:/data/.bitcoin -p 8333:8333 lukechilds/bitcoind:v0.18.1
```
## Build
Build this image yourself by checking out this repo, `cd` ing into it and running:
```
docker build -t lukechilds/bitcoind .
```
You can build a specific version by passing in the `VERSION` build arg:
```
docker build --build-arg VERSION=0.18.1 -t lukechilds/bitcoind:v0.18.1 .
```
You can build a specific architecture by passing in the `ARCH` build arg:
```
docker build --build-arg ARCH=amd64 -t lukechilds/bitcoind:amd64 .
```
For a full list of supported build arg options, check out the [build script matrix](https://github.com/lukechilds/docker-bitcoind/blob/master/.github/workflows/build.yml).
## License
MIT © Luke Childs