Run a local devnet

Integrate your contracts with a local development environment.


To run a local devnet, run the clarinet devnet start command.

Terminal
$
clarinet devnet start
Requirements
This section requires that you have Docker running locally. To install, refer to the Docker documentation.

Under the hood

This command spins up several containers for various services such as a Stacks and Bitcoin node, the Stacks API, and more.

These containers work together to provide all the necessary services for running a local development environment, allowing you to test and interact with your smart contracts locally.

Common errors

If you are getting error: clarinet was unable to create network, make sure you have a container service running locally.

On this page