Charmcraft 3.5 release notes

26 May 2025

Learn about the new features, changes, and fixes introduced in Charmcraft 3.5.

Requirements and compatibility

For development and testing, Charmcraft requires a host with a minimum of 4GB RAM running a Linux distribution compatible with systemd.

All versions of Charmcraft require the following software:

We recommend you install the Charmcraft snap. It comes comes bundled with all its dependencies.

Non-snap installations of Charmcraft have the following dependencies:

What’s new

Charmcraft 3.5 brings the following features, integrations, and improvements.

Updated init templates

The templates generated by charmcraft init now use the new Platforms format.

Editor Integration

The JSON Schema Store now includes a schema for the charmcraft.yaml file.

If your IDE supports fetching JSON schemas from the store, you can now load the latest.

A charmcraft.yaml file open in kate editor showing a hint for the parts key.

Documentation improvements

Many people have made countless improvements to Charmcraft’s documentation this release, from small changes like consistent terminology usage to major rewrites of tutorials.

Feature deprecations

The following features are deprecated in Charmcraft 3.5 and will be removed in Charmcraft 4.0.

Windows support

Charmcraft 3.0 deprecated support for Windows, and the upcoming 4.0 major release will cease it (#1810). Windows users should begin preparing to migrate their workflows to Windows Subsystem for Linux.

CentOS 7 support

CentOS 7 reached its end of life on 30 June 2024. Charmcraft 3.0 will continue supporting it, but Charmcraft 4.0 will cease support for it (#1826).

Bundle registration

New bundle registration ceased on 1 November 2024 and the register-bundle command currently returns an error. It will be removed in Charmcraft 4.0 (#1858).

Scheduled feature deprecations

The following features will be deprecated in Charmcraft 4.0.

Bundle management

In line with the phasing out of bundles, Charmcraft 4.0 will deprecate all bundle management commands (#2113). The schedule for removing this feature hasn’t been set yet.

bundle plugin

In line with the phasing out of bundles, Charmcraft 4.0 will deprecate the bundle plugin (#2114). No schedule has been set for this change yet.

Known issues

The following issues were reported and are scheduled to be fixed in upcoming patch releases.

See individual issue links for any mitigations.

  • #2078 charmcraft clean does not clean all platforms for a charm.

  • #1990 Cannot stage packages with Charmcraft

Fixed bugs and issues

The following bugs have been resolved in Charmcraft 3.5.0:

Contributors

We would like to express a big thank you to all the people who contributed to this release:

@alithethird, @bepri, @erinecon, @evildmp, @jahn-junior, @javierdelapuente, @jdkandersson, @lengau, @medubelko, @tmihoc and @weiiwang01