Skip to content
🍣 A delicious docker box for special Bitcoin and Liquid cookings
Go Shell
Branch: master
Clone or download
altafan and tiero Restart containers & Liquid update (#49)
* change paths

* update liquid conf since using elements

* add restart option to containers

* polish drone & change paths
Latest commit 1a1f9a2 Jun 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources Restart containers & Liquid update (#49) Jun 18, 2019
.gitignore Fix hardcoded ports & logs (#27) May 14, 2019
Gopkg.lock Enhancements (#21) May 2, 2019
Gopkg.toml add cli Mar 29, 2019
LICENSE Initial commit Mar 14, 2019 Update May 21, 2019

🍣 Nigiri Bitcoin

Drone (self-hosted) with branch

Nigiri provides a selection of docker-compose batteries included to have ready-to-use bitcoin environment thats supports different networks and sidechains.

Pre-built binary

No time to make a Nigiri yourself?

  • Download and install nigiri command line interface
$ curl | bash

This will create a directory ~/.nigiri copying there {bitcoin|liquid}.conf you can modify.

  • Lauch Docker daemon (Mac OSX)
$ open -a Docker
  • Close and reopen your terminal, then start Bitcoin and Liquid
$ nigiri start --liquid

That's it. Go to http://localhost:5000 for quickly inspect the Bitcoin blockchain or http://localhost:5001 for Liquid.




Preparation Time: 5 min Cooking Difficulty: Easy
  • Clone the repo:
$ git clone
  • Enter project directory and install dependencies:
$ bash scripts/install

This will create ~/.nigiri copying there the {bitcoin|liquid}.conf you can modify.

  • Build binary
# MacOSX
$ bash scripts/build darwin amd64
# Linux 
$ bash scripts/build linux amd64
  • Remove nigiri
$ bash scripts/clean

Note: Remeber to always clean Nigiri before running install after a pull.


At the moment bitcoind, liquidd and electrs are started on regtest network. testnet and mainnet compose files will be released soon.

  • Start nigiri:
$ ./nigiri start

Use the --liquid flag to let you do experiments with the Liquid sidechain. A liquid daemon and a block explorer are also started when passing this flag.

  • Stop nigiri:
$ ./nigiri stop

Use the --delete flag to not just stop Docker containers but also to remove them and delete the config file and any new data written in volumes.

Nigiri uses the default directory ~/.nigiri to store configuration files and docker-compose files. To set a custom directory use the --datadir flag.

Run the help command to see the full list of available flags.

Nutrition Facts

The list of all available endpoints can be extended with one more POST /faucet which expects a body { "address": <receiving_address> } by enabling faucet.


If you really do love Sathoshi's favourite dish like us at Vulpem Ventures, check the real recipe out and enjoy your own, delicious, hand made nigiri sushi.

You can’t perform that action at this time.