An implementation of Rosetta for Cardano, targeting the version defined in the OpenApi schema. Skip to run if wishing to use a pre-built image from the Docker Hub repository.

Build from anywhere, optionally specifying a network name other than mainnet as a build argument, and accessing cached build layers to reduce the initialization time. You can also build with local source by replacing the GitHub link with .

DOCKER_BUILDKIT=1 \
docker build \
    --build-arg BUILDKIT_INLINE_CACHE=1 \
    --cache-from=inputoutput/cardano-rosetta:master \
    -t inputoutput/cardano-rosetta:1.5.0 \
    https://github.com/input-output-hk/cardano-rosetta.git#1.5.0

DOCKER_BUILDKIT=1 \
docker build \
    --build-arg BUILDKIT_INLINE_CACHE=1 \
    --build-arg NETWORK=testnet \
    --cache-from=inputoutput/cardano-rosetta:master \
    -t inputoutput/cardano-rosetta:1.5.0-testnet \
    https://github.com/input-output-hk/cardano-rosetta.git#1.5.0

Run the locally or pre-built images and mount a single volume into the standard storage location, map the server port to the host, and allocate a suitably-sized /dev/shm. See the complete Docker run reference for full control.

docker run \
  --name cardano-rosetta \
  -p 8080:8080 \
  -v cardano-rosetta:/data \
  --shm-size=2g \
  inputoutput/cardano-rosetta:1.5.0

docker run \
  --name cardano-rosetta-testnet \
  -p 8081:8080 \
  -v cardano-rosetta-testnet:/data \
  --shm-size=2g \
  inputoutput/cardano-rosetta:1.5.0-testnet

Set ENVs for optional runtime configuration

-e MODE=offline

See Rosetta docs for information on modes

• online - default
• offline

Specify the TTL without needing to access an online method. Default: 1000

• trace
• debug
• info - default
• warn
• error
• fatal

Default: 25

As per the release notes, you may be required to refresh the state managed by cardano-db-sync. This can be achieved without requiring a network re-sync using the following command:

docker stop cardano-rosetta && \
docker rm cardano-rosetta && \
docker run --rm -v cardano-rosetta:/data ubuntu rm -rf /data/postgresql /data/db-sync

Now create a new container using the run instructions above. Sync progress will be logged by the new container.