Skip to content

Running application

The sunodo run command will execute a Cartesi node for the application previously built with sunodo build.


By default the node works on non-verbose mode, and only outputs logs coming from the user backend application. In case the user needs more information there is the --verbose command option.

Blockchain configuration

Sunodo runs a local private chain powered by anvil at port 8545. All contracts of the Cartesi Rollups framework are already deployed, and theirs addresses can be inspected using sunodo address-book.

The private chain by default has a block time of 5 seconds, controlled by --block-time <seconds>, and runs on auto-mine mode.


By default the node closes an epoch once a day, but this can be controlled by the --epoch-duration <seconds> command option. It's an important settings when it comes down to voucher execution.

Rollups Node configuration

You can create a .sunodo.env file in the root of your project to configure the node.

All Rollups Node services can be configured using environment variables.

For ex., in case you want to change the default deadline for advancing the state for the rollups-advance-runner service.

cat .sunodo.env

Check the configuration options for each service in the Rollups Node documentation.

No-backend mode

Sunodo run also supports running a node without the user application backend packaged as a Cartesi machine. In this case the user application can be executed on the host, without the concern of being compiled to RISC-V.

This is a useful development workflow help, but there are some caveats the user must be aware:

  1. The application will eventually need to be compiled to RISC-V, or use a RISC-V runtime in case of interpreted languages;
  2. In this mode the application will not be running inside the sandbox of the Cartesi machine, and will not block operations that won't be allowed when running inside a Cartesi machine, like accessing remote resources;
  3. This mode only works for applications that use the Cartesi Rollups HTTP API, and doesn't work with applications using the low-level API;
  4. Performance inside a Cartesi machine will be much lower than running on the host.

When launching a node with the --no-backend the user must then start his application on the host and fetch inputs from the endpoint running at