This repository is used to build a container image holding the configuration files used for a Cardano Node (Haskell) and other ecosystem applications.
This project provides Cardano network configuration files in a container image format. It includes configurations for the following networks:
- mainnet
- preprod
- preview
- sanchonet
- devnet (a single-node development network maintained in this repository)
Published images are available from both registries:
- Docker Hub:
blinklabs/cardano-configs - GitHub Container Registry:
ghcr.io/blinklabs-io/cardano-configs
Use latest for the most recent image, or pin a version tag such as
20260817-1 for reproducible builds. For stronger reproducibility, pin an
image digest (@sha256:...) or use immutable tags in the registry.
The most common use case is to copy configuration files during Docker multi-stage builds:
FROM ghcr.io/blinklabs-io/cardano-configs:latest AS cardano-configs
FROM your-base-image
# Copy all network configurations
COPY --from=cardano-configs /config/ /opt/cardano/config/You can also run the container directly to copy configuration files to a mounted volume:
# Copy all network configurations
docker run -v "$(pwd)/configs:/output" ghcr.io/blinklabs-io/cardano-configs:latest /output
# Copy specific network configuration
docker run -v "$(pwd)/configs:/output" ghcr.io/blinklabs-io/cardano-configs:latest /output mainnetdocker build -t cardano-configs .Configuration files are fetched from:
- Standard networks: https://book.play.dev.cardano.org/environments/
- Devnet: maintained in this repository under
config/devnet. It began as a copy of the hydra devnet (https://github.com/cardano-scaling/hydra) but now diverges on protocol version, slot and epoch timing, and Plutus cost models, soupdate.shno longer re-fetches it.
To update the configuration files, run:
./update.shThis project is licensed under the MIT License - see the LICENSE file for details.