Skip to content
You are reading GoQuorum development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.

GoQuorum Wizard

GoQuorum Wizard is a command line tool that allows users to set up a development GoQuorum network on their local machine in less than 2 minutes.

Quorum wizard terminal demo

Installation

quorum-wizard is written in JavaScript and designed to be installed as a global NPM module and run from the command line. Make sure you have Node.js/NPM installed.

Using npm:

npm install -g quorum-wizard

Using Yarn:

yarn global add quorum-wizard

Using GoQuorum Wizard

Once the global module is installed, run:

quorum-wizard

The wizard walks you through setting up a network, either using our quickstart settings (a simple 3-node GoQuorum network using Raft consensus), or customizing the options to fit your needs.

Options

You can also provide these flags when running quorum-wizard:

  • -q, --quickstart create 3 node Raft network with Tessera and Cakeshop (no user-input required)
  • -v, --verbose Turn on additional logs for debugging
  • --version Show version number
  • -h, --help Show help

Note

npx is also way to run npm modules without the need to actually install the module. Due to quorum-wizard needing to download and cache the quorum binaries during network setup, using npx quorum-wizard will not work at this time.

Interacting with the Network

To explore the features of GoQuorum and deploy a private contract, follow the instructions on Interacting with the Network

Troubleshooting

EACCES error when doing global npm install:

Developing

  1. Clone this repo to your local machine.
  2. yarn install to get all the dependencies.
  3. yarn test:watch to automatically run tests on changes
  4. yarn start to automatically build on changes to any files in the src directory
  5. yarn link to use your development build when you run the global npm command
  6. quorum-wizard to run (alternatively, you can run node build/index.js)

Contributing

GoQuorum Wizard is built on open source and we invite you to contribute enhancements. Upon review you will be required to complete a Contributor License Agreement (CLA) before we are able to merge. If you have any questions about the contribution process, please feel free to send an email to quorum@consensys.net.

ConsenSys has acquired Quorum from J.P. Morgan. Please read the FAQ.
Questions or feedback? You can discuss issues and obtain free support on GoQuorum Slack channel.
For paid professional support by ConsenSys, contact us at quorum@consensys.net