Practical overview
When it fits
Use Nigiri when a Bitcoin development workflow needs a locally managed regtest node, explorer and test utilities, or when a local setup also needs the documented Liquid or Lightning components.
Who it is for
- Bitcoin application developers who need a local regtest node and tools for testing transactions.
- Developers who want to inspect local blocks and blockchain activity through an explorer.
- Teams testing Bitcoin alongside documented Liquid or Lightning services in a local environment.
Documented uses
- Start and stop a local Bitcoin regtest environment.
- Inspect local blockchain activity in Electrum.
- Fund test addresses, broadcast raw transactions and generate blocks for development workflows.
- Add documented Elements/Liquid and Lightning services when those are relevant to a test setup.
- Inspect service logs and use bundled command-line interfaces.
Requirements & limits
The project provides a pre-built CLI installer and documents a Docker-based setup. Its repository lists the MIT license.
- Docker is required to run the Compose-based services; Windows users are advised to use WSL with Docker integration.
- The core environment is Bitcoin regtest; Liquid and Lightning services are enabled with separate flags.
- On macOS Monterey and later, AirPlay Receiver can occupy port 5000, which the README identifies as a possible explorer conflict.
- The README documents
nigiri stop --deleteas removing containers, configuration and new data written in volumes.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install Nigiri and start its local environment
Install the Nigiri CLI, start the documented Bitcoin and Ark services, and open the local blockchain explorer.
Before you start
- A Docker daemon configured for the computer.
- On Windows, the README recommends WSL with Docker configured to integrate with it.
Steps
Install the Nigiri CLI using the documented pre-built binary installer.
Ensure the Docker daemon is running; on macOS, the README shows
open -a Docker.Close and reopen the terminal, then run
nigiri start --ark.Open
http://localhost:5000to inspect the Bitcoin blockchain.
Expected outcome
A local Nigiri environment with Bitcoin and Ark services, plus an explorer at localhost:5000.
Guide limitations
- The README notes that on macOS Monterey and later, AirPlay Receiver may conflict with the explorer on port 5000; it documents disabling AirPlay Receiver or changing the Esplora port.
- The README recommends WSL for Windows and Docker's WSL integration.
Compare options for Blockchain exploration
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Nigiri | Start and stop a local Bitcoin regtest environment. | CLI, Docker, Linux | The project provides a pre-built CLI installer and documents a Docker-based setup. Its repository lists the MIT license. |
| Eth Components | Display an address, balance and wallet together as an account view. | Web |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 10 October 2026
- Original website title
- vulpemventures/nigiri · Official homepage title · retained in its source language

