How-to guides

These pages provide directions for completing tasks and solving problems with Charmcraft.

Install Charmcraft

Charmcraft can be installed in a few short steps, regardless of if you are installing on Linux, macOS, or an isolated environment.

• Manage Charmcraft

Craft

Once you initialize the project, you can modify a charm’s project file and source code to include any libraries, parts, or other assets your application may require.

• Manage charms

• Manage 12-factor app charms

• Select charm platforms

• Manage resources

• Manage libraries

• Manage extensions

Publish and release

When you’re ready to distribute your charm, Charmcraft provides commands to register it, publish it to Charmhub, and manage its releases.

• Build a charm remotely

• Manage the current Charmhub user

• Manage names

• Manage icons

• Manage revisions

• Manage tracks

• Manage channels

Migrate between plugins

To migrate away from the default Charm plugin, refer to the guide for your charm’s build system:

• Migrate from the Charm plugin to the Poetry plugin

• Migrate from the Charm plugin to the Python plugin

• Migrate from the Charm plugin to the uv plugin

Migrate bases

When a new Ubuntu base becomes available, refer to the appropriate migration guide to update a charm to the new base:

• Change to the Ubuntu 26.04 LTS base