v2025-06-05

Overview:

Nixpkgs has been updated to 25.05 and nix to 2.29-maint. NixosModules and just recipes with breaking changes from those updates were fixed along with other miscellaneous improvements detailed below.

Details:

Important versioning updates in this release are underlined:

Component	Release	Pre-release
cardano-address	4.0.0	N/A
cardano-cli	10.8.0.0	10.8.0.0
cardano-db-sync	13.6.0.5	13.6.0.5
cardano-node	10.4.1	10.4.1
cardano-ogmios	6.11.2	N/A
mithril	2517.1	346b447
nix*	2.29.1	N/A
nixpkgs*	25.05	N/A

* = For nixos machine deployments

• Bumps colmena to master HEAD, adds colmena to CI and updates just template recipes for breaking changes
• Bumps nixpkgs from 24.11 -> 25.05
• Bumps nix from 2.25.x -> 2.29.1
• Bumps flake-parts to main HEAD and makes nixosModule adjustments for breaking changes
• Bumps opentofu-registry and makes adjustments for breaking changes introduced with alpha and beta tag versioning
• Optimizes the devShell by removal of the haskellNix input which is no longer needed
• Improves the nixosModule profile-aws-ec2-ephemeral.nix with default ext2 mounting type and auto-mount on create features
• Improves the nixosModule profile-grafana-alloy.nix for merging additional config
• Adds default auto-gc of generations more than 30 days old to reduce aged packages and EOL sec triggers
• Fixes recipe tofu cli arg passing for some use cases
• Updates all three just demo recipe types to hard fork through to Plomin protocol version 10 and adds additional control params
• Updates ip module abort and warn module messages with new info
• Refactors all template script/recipes-* add-ons into scripts/recipes/*
• Refactors demo recipes into scripts/recipes-* dir for easier Justfile diffing and patching

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• While not exactly breaking changes, there are a few updates in this release which are more disruptive than usual and deserve a call to attention:
  • If the Justfile is patched in the list of action items below, but the scripts/recipes-* files are not also migrated or vice-versa, some recipes will stop working
  • Deploying machines with this release will stop and restart more services than usual due to the nixpkgs update. Since a new kernel is also involved, a reboot after deployment should be done. The first deployment may report some secrets failures until reboot after which a second deployment will succeed.

Recommended Updates:

• Update the cardano-parts pin to this release version v2025-06-05
• Apply the template Justfile diff and patch or clone recipes on files described below.

Action Items:

Diff and patch the following files with just template-diff "$FILE" and then just template-patch "$FILE". Looking at the short PR diff for these files found at directory templates/cardano-parts-project/ prior to diffing and patching against your own repo can also be helpful.

Alternatively, if you know you would just like to mirror any of these template files without diffing or patching, use the
just template-clone "$FILE"` recipe.

flake/nixosModules/ip-module-check.nix               # To update the abort and warn ip module messages with new info
flake/opentofu/cluster.nix                           # To use nixos 25.05 AMIs by default
Justfile                                             # To relocate external recipes to an organized subdir and split demo recipes into that subdir also
scripts/cost-models/mainnet-plutusv3-pv10-prep.json  # A cost model reference file, matching mainnet to prepare for Conway to Plomin HF used in demo recipes
scripts/recipes/aws.just                             # Moved from scripts/recipes-aws.just
scripts/recipes-aws.just                             # Moved to scripts/recipes/aws.just
scripts/recipes/custom.just                          # Moved from scripts/recipes-custom.just
scripts/recipes-custom.just                          # Moved to scripts/recipes/custom.just
scripts/recipes/demo.just                            # Demo recipes externalized from the main Justfile
scripts/recipes/governance.just                      # Moved from scripts/recipes-governance.just
scripts/recipes-governance.just                      # Moved to scripts/recipes/governance.just

• Machines deployed with this release should be rebooted after the initial deployment to nixpkgs 25.05 to ensure use of the new kernel.

v2025-05-22

Overview:

Sets node release to 10.4.1, cardano-cli release to 10.8.0.0 and mithril to v2517.1. Adds mithril ancillary key support for signed volatile and ledger state. Switches to a blockPerf fork which can be used without publishing metrics to CF, ex: for testnet usage. Includes additional misc fixes and improvements detailed below.

Details:

Important versioning updates in this release are underlined:

Component	Release	Pre-release
cardano-address	4.0.0	N/A
cardano-cli	10.8.0.0	10.8.0.0
cardano-db-sync	13.6.0.5	13.6.0.5
cardano-node	10.4.1	10.4.1
cardano-ogmios	6.11.2	N/A
mithril	2517.1	346b447

• Adds snapshot-converter to pkgs, devShell, nixosCfg systemPackages
• Adds pool margin parameterization for job-register-stake-pools nix job
• Adds a blockperf fork which allows blockperf usage without publishing metrics to CF; ex: testnet usage
• Adds nixosConfigurations to hydraJobs and automatically disables abortOnMissingIpModule as needed for the hydra builds to enable building without ipv4/6 secrets present
• Adds location keys to all nixosModules to avoid double import eval failures
• Adds ssm-session-manager to the ops devShell for movement towards closed port 22 ssh
• Adds mithril ancillary key support for ledger and volatile component snapshot pull (may still replay genesis in some cases until the next mithril release -- this is a known issue)
• Updates cardano-node systemd preStart scripts, bash entrypoint scripts and process-compose jobs to utilize mithril ancillary keys for preview and preprod networks
• Fixes template recipe apply-bootstrap failures when the .ssh_key is missing
• Cleans up pre-push unnecessary symlink pollution

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• N/A

Recommended Updates:

• Update the cardano-parts pin to this release version v2025-05-22
• Apply the template Justfile diff and patch or clone recipes on files described below.

Action Items:

Diff and patch the following files with just template-diff "$FILE" and then
just template-patch "$FILE". Looking at the short PR diff for these files
found at directory templates/cardano-parts-project/ prior to diffing and
patching against your own repo can also be helpful.

Alternatively, if you know you would just like to mirror any of these template
files without diffing or patching, use the just template-clone "$FILE"
recipe.

flake/colmena.nix                       # To set a string value if ip-module is not present
flake/hydraJobs.nix                     # To build nixosCfgs on hydra by default
flake/nixosModules/ip-module-check.nix  # To use perNode {abort,warn}OnMissingIpModule config instead of whole cluster config for individual machine overriding
Justfile                                # To fix an apply-bootstrap recipe when .ssh_key is missing
README.md                               # To better describe minimum nix requirements

v2025-05-01

Overview:

Sets node pre-release to 10.4.1, cardano-cli pre-release to 10.8.0.0.

Details:

Important versioning updates in this release are underlined:

Component	Release	Pre-release
cardano-address	4.0.0	N/A
cardano-cli	10.7.0.0	10.8.0.0
cardano-db-sync	13.6.0.5	13.6.0.5
cardano-node	10.3.1	10.4.1
cardano-ogmios	6.11.2	N/A
mithril	2513.0	47178ad

Also:

• Bumps cardano-node-service-ng and iohk-nix-ng pins for node 10.4.1 pre-release compatibility
• Adds snapshot-converter-ng to pkgs, devShell, nixosCfg systemPackages

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• N/A

Recommended Updates:

• Update the cardano-parts pin to this release version v2025-05-01

Action Items:

• N/A

v2025-04-28

Overview:

Sets node release to 10.3.1, cardano-cli release to 10.7.0.0.

Details:

• Important versioning updates:
  • Cardano-node release is now 10.3.1
  • Cardano-cli release is now 10.7.0.0
  • Cardano-address is now 4.0.0
• Adds a module deduplication key
• Fixes CI spin up job tests for the node release version update

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• N/A

Recommended Updates:

• Update the cardano-parts pin to this release version v2025-04-28

Action Items:

• N/A

v2025-04-17

Overview:

Sets node pre-release (ng) to 10.3.1 and cardano-cli pre-release (ng) to 10.7.0.0 and updates nix jobs and ci to accommodate cardano-cli pre-release breaking changes. Improves a show_current_forging prepared psql query and makes other miscellaneous improvements.

Details:

• Important versioning updates:
  • Cardano-node pre-release (ng) is now 10.3.1
  • Cardano-cli pre-release (ng) is now 10.7.0.0
  • Ogmios is now v6.11.2
  • Cardano-wallet is now v2025-03-31
  • Credential manager binaries are now from 0.1.3.0
• Adds a trace-verbose trace to the .#opentofu.cluster to aid with tofu machine debugging
• Fixes nix jobs due to breaking changes in cardano-cli 10.7.0.0
• Fixes ci due to breaking changes in cardano-cli 10.7.0.0
• Updates template grafana dashboards to remove any explicit prometheus data source ids for portability
• Improves template justfile demo recipes to utilize dynamic wait times between nix jobs
• Updates template opentofu resource tagging to from iog to ioe
• Improves license attribution of the parts notice file and template for downstream notice files
• Improves the show_current_forging prepared psql statement to include ticker/dns/url info
• Adds the blockfrost-platform binary to the default devShell and pkgs flakeModule
• Improves ci with support for 3rd party fork PRs

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• N/A

Recommended Updates:

• Update the cardano-parts pin to this release version v2025-04-17
• Apply the template Justfile diff and patch or clone recipes on files described below.

Action Items:

Diff and patch the following files with just template-diff "$FILE" and then just template-patch "$FILE". Looking at the short PR diff for these files found at directory templates/cardano-parts-project/ prior to diffing and patching against your own repo can also be helpful.

Alternatively, if you know you would just like to mirror any of these template files without diffing or patching, use the just template-clone "$FILE" recipe.

flake/cluster.nix                                                       # For iog -> ioe default tag change
flake/opentofu/cluster.nix                                              # For trace-verbose machine tracing
flake/opentofu/grafana/dashboards/cardano-blockperf.json                # To remove prometheus data source uid
flake/opentofu/grafana/dashboards/cardano-mithril.json                  # To remove prometheus data source uid
flake/opentofu/grafana/dashboards/cardano-node.json                     # To remove prometheus data source uid
flake/opentofu/grafana/dashboards/cardano-node-new-tracing.json         # To remove prometheus data source uid
flake/opentofu/grafana/dashboards/cardano-node-p2p-new-tracing.json     # To remove prometheus data source uid
flake/opentofu/grafana/dashboards/cardano-performance.json              # To remove prometheus data source uid
flake/opentofu/grafana/dashboards/cardano-performance-new-tracing.json  # To remove prometheus data source uid
Justfile                                                                # For dynamic wait times in the state demo recipes
NOTICE                                                                  # For improved notice attribution

v2025-04-03

Overview:

Sets node release to 10.2.1, cardano-cli release to 10.4.0.0, cardano-db-sync to 13.6.0.5 and mithril-cli to v2513.0.

Details:

• Important versioning updates:
  • Cardano-node release is now 10.2.1
  • Cardano-cli release is now 10.4.0.0
  • Cardano-db-sync is now 13.6.0.5
  • Mithril-cli is now v2513.0
• Adds profile-cardano-node-topology SRV record support for cardano-node producers
• Fixes a process-compose node health check broken in newer versions of cardano-cli and adds node binary to the nixosCfgs system path

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• N/A

Recommended Updates:

• Update the cardano-parts pin to this release version v2025-04-03

Action Items:

• N/A

v2025-02-26

Overview:

Sets node pre-release (-ng) to 10.2.1, cardano-cli pre-release to 10.4.0.0 and mithril-cli to v2506.0. Cleans up deprecated environments such as private, shelley-qa and sanchonet. Includes a number of improvements.

Details:

• Important versioning updates:
  • Cardano-node pre-release (-ng) is now 10.2.1
  • Cardano-cli pre-release (-ng) is now 10.4.0.0
  • Mithril-cli is now v2506.0
• Uses a capkgs improvement for faster machine builds by eliminating rewrites of fetch-closure package paths
• Adds a mithrilAllowedNetworks list consumed by mithril in node entrypoints, nixosCfgs and process-compose
• Adds a services.alloy.extraAlloyConfig option for alloy configuration extensibility
• Adds aws route53 SRV record support
• Makes the config.aws attributes normal rather than a submodule for extensibility
• Cleans up deprecated environments in alerts, recipes, templates
• Improves the readme template, largely around secrets handling

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• N/A

Recommended Updates:

• Update the cardano-parts pin to this release version v2025-02-26
• Apply the template Justfile diff and patch or clone recipes on files described below.

Action Items:

Diff and patch the following files with just template-diff "$FILE" and then just template-patch "$FILE". Looking at the short PR diff for these files found at directory templates/cardano-parts-project/ prior to diffing and patching against your own repo can also be helpful.

Alternatively, if you know you would just like to mirror any of these template files without diffing or patching, use the just template-clone "$FILE" recipe.

Justfile                                                          # Deprecated env cleanup
README.md                                                         # Improved docs mostly re: secrets handling
flake/opentofu/cluster/route53.nix-import                         # AWS Route53 SRV DNS record support added
flake/opentofu/grafana/alerts/cardano-node-divergence.nix-import  # Deprecated env cleanup
flake/opentofu/grafana/alerts/cardano-node-quality.nix-import     # Deprecated env cleanup
flake/scripts/dbsync-pool-perf.sql                                # Deprecated env cleanup
flake/scripts/recipes-governance.sql                              # Deprecated env cleanup

v2025-02-04

Overview:

A nixosModule, profile-aws-ec2-ephemeral has been added to support ec2 instances with ephemeral storage block devices, offering auto-format and mount with RAID0 creation for multiple devices. The aws ec2 spec file was updated. A number of small fixes and improvements were added.

Details:

• Bumps auth-keys-hub for package tests modification
• Update the aws ec2 spec file
• Adds isd to the basic nixosModule profile for fast interactive systemd service discovery and interaction
• Prepares for node 10.2.x breaking changes
• Adjusts the timing of template demo recipes to avoid intermittent failure
• Adds a profile-aws-ec2-ephemeral nixosModule to support auto format and mounting of xfs ephemeral block devices with optional RAID0 support
• Adds profile-aws-ec2-ephemeral to the colmena machine definition file default module import list
• Fixes some template gov action query edge cases and jq parse failures

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• N/A

Recommended Updates:

• Update the cardano-parts pin to this release version v2025-02-04
• Apply the template Justfile diff and patch or clone recipes on files described below.

Action Items:

Diff and patch the following files with just template-diff "$FILE" and then just template-patch "$FILE". Looking at the short PR diff for these files found at directory templates/cardano-parts-project/ prior to diffing and patching against your own repo can also be helpful.

Alternatively, if you know you would just like to mirror any of these template files without diffing or patching, use the just template-clone "$FILE" recipe.

Justfile                         # Timing adjustments for the state demo recipes to avoid intermittent errors
flake/colmena.nix                # For an aws ec2 ephemeral support module
scripts/recipes-governance.just  # For query-gov-action-status recipe update and fixes

v2025-01-17

Overview:

Cardano-node has been updated to 10.1.4, cardano-cli and the -ng variant to 10.1.1.0 and 10.2.0.0 respectively, and mithril to v2450. Colmena has been updated to utilize a new pure flake evaluation approach. New nix jobs were added to support a new "next-gen" network spin up method, which supports network creation with a fork directly to Conway and then retirement of the genensis bootstrap pool in favor of on-chain registered backbone pools. CI tests to support these new jobs were added. The recipe to query governance actions was updated with the latest voting calculations and the output was improved with color and additional reporting totals. A psql prepared statement for voting activity over time was added to the postgres module. Other small miscellaneous improvements and clean up were made.

Details:

• Important versioning updates:
  • Cardano-node release and pre-release (-ng) are now 10.1.4
  • Cardano-cli release is now 10.1.1.0
  • Cardano-cli pre-release (-ng) is now 10.2.0.0
  • Mithril is now v2450
  • Colmena is now main for a pure experimental flake eval feature
• Bumps capkgs for cardano-node, cardano-cli, mithril and colmena updates described above
• Adds a show_voting_by_hour prepared psql statement to the psqlrc of the profile-cardano-postgres nixosModule
• Adds new nix jobs of job-gen-custom-node-config-data-ng and job-retire-bootstrap-pool to support a new next-gen (-ng) network spin up method
• Adds a nix jobs CI test for a new next-gen (-ng) spin up method with a fork directly to Conway using a genesis bootstrap pool
• Updates nix jobs CI tests for cardano-cli breaking changes
• Updates nix jobs for cardano-cli breaking changes
• Updates the readme template for spin-up instructions of a new cardano-parts cluster
• Updates the recipes-governance.just template file with calculation updates and misc improvements
• Updates the openTofu provisioning template code to support IPV4/IPV6 dual stack resource migration completion
• Fixes a memory unit calculation in the profile-cardano-node-group nixosModule

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• For downstream clusters which have completed the IPV4/IPV6 dual stack migration described in a prior cardano-parts release, be sure to patch the diff mentioned in the flake/opentofu/cluster.nix file below as this will prevent any AAAA DNS resource creation errors upon provisioning new machines.

Recommended Updates:

• Update the cardano-parts pin to this release version v2025-01-17
• Apply the template Justfile diff and patch or clone recipes on files described below.

Action Items:

Diff and patch the following files with just template-diff "$FILE" and then just template-patch "$FILE". Looking at the short PR diff for these files found at directory templates/cardano-parts-project/ prior to diffing and patching against your own repo can also be helpful.

Alternatively, if you know you would just like to mirror any of these template files without diffing or patching, use the just template-clone "$FILE" recipe.

.gitignore                       # For support of next-gen network spin up method
.sops.yaml                       # For support of next-gen network spin up method
Justfile                         # For colmena update and support of next-gen network spin up method
flake/colmena                    # For colmena update (only need the `self` line at the file start and `colmenaHive` line at the file end
flake/opentofu/cluster.nix       # For IPV4/IPV6 dual-stack modification completion
scripts/recipes-governance.just  # For query-gov-action-status recipe calc update and misc improvements

v2024-12-19

Overview:

Nixpkgs has been updated to 24.11 and nix to 2.25.3. NixosModules and template just recipes with breaking changes from those updates were fixed. A nix jobs GHA CI test was added to verify environment spin up procedure. Template scripts were updated for compatibility with latest cardano-node protocol version and recent cardano-cli breaking changes, along with other miscellaneous improvements.

Details:

• Important versioning updates:
  • Nixpkgs is now 24.11
  • Nix is now 2.25.3 (maintenance)
  • Nushell (used in devShell just recipes) is now 0.100.0
• Adds cardano-testnet to flakeModule pkgs and test+ devShells (ops included)
• Adds a template just cardano-testnet recipe to handle env setup for the cardano-testnet binary
• Adds a GHA CI test for nix jobs involving create-cardano and create-testnet-data environment spinups
• Adds nushell polars to the min+ devShells (ops included)
• Updates nixpkgs to 24.11 and includes required breaking change fixes to nixosModules
• Updates the template faucet dedelegation script for compatibility with cardano-node protocol version 10
• Updates the template tofu file for nixos 24.11 AMI images
• Fixes template recipes involving nushell breaking changes from 0.93 to 0.100
• Fixes a bug in the template setup delegation accounts python script
• Fixes the template just start-demo recipe for cardano-cli 10.x breaking changes
• Tunes the template alert for the varnish low cache hit rate threshold to reduce false positives
• Bumps iohk-nix[-ng] for p2p established peers tuning
• Adds template colmena TCP transmission optimization code for reducing round-tripping over long distances

Breaking Changes, Recommended Updates and Action Items:

Breaking:

• If you have a pre-existing nushell config at ~/.config/nu/config.nu, the nushell update to version 0.100.0 which came with nixpkgs 24.11 may generate an error when entering a nu shell or running nushell scripts. In this case, simply delete the existing ~/.config/nu/config.nu file, or update it to a compatible version, for example, here

Recommended Updates:

• Apply the template Justfile diff and patch on the Justfile before bumping the cardano-parts pin to this release
  • This will break the just recipes until the cardano-parts pin is updated in the next step
• Update the cardano-parts pin to this release version v2024-12-19
  • This will fix the just recipes which already have the breaking change fixes from the prior step
• Continue to apply the template Justfile diff and patch or clone recipes on files described below.

Action Items:

Diff and patch the following files with just template-diff "$FILE" and then just template-patch "$FILE". Looking at the short PR diff for these files found at directory templates/cardano-parts-project/ prior to diffing and patching against your own repo can also be helpful.

Alternatively, if you know you would just like to mirror any of these template files without diffing or patching, use the just template-clone "$FILE" recipe.

# Apply the diff and patch or clone *before* updating the cardano-parts pin to `v2024-12-19`
Justfile                                          # Nixpkgs 24.11 breaking change fixes 

# Apply the diff and patch or clone *after* updating the cardano-parts pin to `v2024-12-19`
.envrc                                            # For nix-direnv 3.0.6
flake/colmena.nix                                 # Optional: for the transmission optimization `tcpTxOpt` module code
flake/opentofu/cluster.nix                        # For 24.11 nixos AMI tofu filtering
flake/opentofu/grafana/alerts/varnish.nix-import  # For a less noisy varnish low cache rate alert
scripts/restore-delegation-accounts.py            # For PV 10 compatible dedelegation script
scripts/setup-delegation-accounts.py              # For a script bug fix

• Machines deployed with this release should be rebooted after the initial deployment to nixpkgs 24.11 to ensure use of the new kernel.