# Stork 2.1.2 Release Notes, April 2, 2025 Welcome to Stork 2.1.2, the third development release in the 2.1 series. The changes introduced in this version are: 1. **Zone list viewer**: A major feature added in this release is the Stork agent's ability to retrieve and list zone information using BIND's statistics channel. For larger and heavier-traffic deployments this operation might incur some performance penalty, so it is only triggered manually. To avoid needless burden on the BIND servers, this information is retrieved once and cached locally by the agents [#1669]. The Stork server is able to pull this data and show it to the user [#1711]. This retrieval process is views aware. The zone list can now be filtered using various properties: full or partial zone name, full or partial serial, zone type (primary, secondary, built-in, etc.), and others [#1716, #1717]. Since this is the first time Stork provides a major DNS feature, we are eager to get users' feedback and suggestions. 2. **DNS hackathon**: Part of the Stork team participated in the DNS hackathon organized by RIPE and Netnod in Stockholm in March 2025. Much of the zone list feature was done in part as a preparation for the hackathon [#1721]. Besides the features described above, we did some experiments with two other DNS implementations, PowerDNS and NSD. While the PowerDNS container was added to our demo setup [#1710], the biggest advantage was gaining valuable experience working with other DNS implementations. We have a prototype for NSD support, but to make support for other implementations viable in the long term, some code refactoring is necessary and will come in future releases. We also added limited parsing of the BIND 9 configuration files, specifically to be able to extract TSIG keys and understand their mapping to views [#1715]. 3. **Query hit ratio and views**: The query hit ratio statistics shown in the apps page are now views aware. There is a separate statistic for each view shown [#1675]. 4. **Mostly printable identifiers**: Some DHCP clients use identifiers that contain both printable and a small number of non-printable characters. Earlier Stork versions displayed these identifiers in hex; starting with this release, the identifiers with non-printable bytes can now be displayed in text form [#1682]. 5. **UI improvements**: It is now possible to customize links to a Grafana dashboard, which may be useful if there are multiple Stork servers that share a common Grafana instance [#1720]. The host reservations list can now be searched and filtered using a specific subnet [#1725]. The events panel no longer uses an expensive API call [#1678]. We rephrased the config review checker report to recommend using the `reservations-out-of-pool` option instead of the deprecated `out-of-pool` option [#1668]. We performed another round of UI proofreading [#1708]. 6. **Bug fixes**: We fixed a problem where the DHCP option view and edit forms handled option content incorrectly if they contained a backslash [#1617]. 7. **Build improvements**: We updated the docker-compose files to use older port export syntax; this fixes a problem when running the demo with older Docker versions [#1748]. The demo now uses Kea version 2.7.6; this change was useful to prove that Stork is able to use relative paths for the hooks [#1686]. 8. **Security**: Dependencies were updated [#1758]. 9. **Documentation**: We extended the installation instructions. While using a script from Cloudsmith remains the most convenient and popular solution, some users may choose to perform all the steps on their own, rather than run a script [#1719]. We documented python requirements in the ARM [#1698]. 10. **Testing and CI**: We added missing tags to CI jobs configuration [#1671]. The linter for changelog is now more flexible [#1687]. We updated our test environment: containers are no longer permitted to permanently change the configuration files during system tests [#1692]. Please see this link for known issues: https://gitlab.isc.org/isc-projects/stork/-/wikis/Known-issues. ## Incompatible Changes There are no incompatible changes in this release. ## Release Model Stork has bi-monthly development releases. We encourage users to test the development releases and report back their findings on the stork-users mailing list, available at https://lists.isc.org/mailman/listinfo/stork-users, or report bugs at https://gitlab.isc.org/isc-projects/stork/-/issues/. This text references issue numbers. For more details, visit the Stork GitLab page at https://gitlab.isc.org/isc-projects/stork/-/issues. ## License Stork is released under the Mozilla Public License, version 2.0. https://www.mozilla.org/en-US/MPL/2.0 ## Download The easiest way to install the software is to use native deb or RPM packages. They can be downloaded from: https://cloudsmith.io/~isc/repos/stork/ The Stork source and PGP signature for this release may be downloaded from: https://downloads.isc.org/isc/stork The signature was generated with the ISC code-signing key, which is available at: https://www.isc.org/pgpkey ISC provides documentation in the Stork Administrator Reference Manual (ARM). It is available on ReadTheDocs.io at https://stork.readthedocs.io/en/latest/, and in source form in [the doc/ directory](https://gitlab.isc.org/isc-projects/stork/-/tree/master/doc). We ask users of this software to please let us know how it worked for you and what operating system you tested on. Feel free to share your feedback on the stork-users mailing list (https://lists.isc.org/mailman/listinfo/stork-users). We would also like to hear whether the documentation is adequate and accurate. Please open tickets in the Stork GitLab project for bugs, documentation omissions and errors, and enhancement requests. We want to hear from you even if everything worked. ## Support Free best-effort support is provided by our user community via a mailing list. Information on all public email lists is available at https://www.isc.org/mailinglists/. If you have any comments or questions about working with Stork, please share them to the stork-users list (https://lists.isc.org/mailman/listinfo/stork-users). Bugs and feature requests may be submitted via GitLab at https://gitlab.isc.org/isc-projects/stork/issues. ## Changes The following summarizes changes and important upgrades since the previous Stork release. * 504 [build] slawek Updated dependencies including the Go 1.24.1, Angular 18 and several JavaScript, Python, Ruby and Go packages. (Gitlab #1758) * 503 [bug] slawek Fixed displaying a DHCP option value with an escaped comma. (Gitlab #1617) * 502 [func] slawek The hex identifiers with non-printable bytes can now be displayed in text form. (Gitlab #1682) * 501 [func] slawek Added server settings to specify the Grafana Dashboard IDs. (Gitlab #1720) * 500 [doc] slawek Updated Stork installation instructions in the ARM to direct users to the Cloudsmith documentation for setting up the repository. (Gitlab #1719) * 499 [func] marcin, piotrek Stork server now supports DNS zones filtering using new controls in the zone viewer. (Gitlab #1716, #1717) * 498 [func] marcin, piotrek Implemented fetching the DNS zones from Stork agents to Stork server. Implemented new view in Stork UI which retrieves and displays all fetched DNS zones. (Gitlab #1669, #1711) * 497 [func] marcin BIND9 tab now shows the query hit ratio for each view. (Gitlab #1675) * 496 [build] marcin Added a PowerDNS docker container to the demo environment. (Gitlab #1710) * 495 [build] tomek Updated docker files to use older syntax for port exporting. This improves compatibility with older Docker versions. (Gitlab #1748) * 494 [doc] slawek Rephrased a config review checker report to recommend using 'reservations-out-of-pool' option instead of the deprecated 'out-of-pool' option. (Gitlab #1668) * 493 [build] slawek Upgraded the Kea to version 2.7.6 in the demo. (Gitlab #1686) * 492 [ui] bscott Added a search/filter to the "Subnet" drop-down-list in the "host" form used for DHCP Reservations. (Gitlab #1725) Thank you again to everyone who assisted us in making this release possible. We look forward to receiving your feedback.