How to publish your charm on Charmhub¶
Publishing your charm enables other people to deploy your charm with juju deploy <charm-name>. Anyone who knows your charm’s name can also see the Charmhub page for your charm.
Before publishing your charm, review the charmcraft.yaml file to make sure you’ve provided appropriate metadata. The metadata controls what appears on the Charmhub page for your charm. See Charmcraft | Configure package information.
Publish your charm¶
To publish your charm, follow the instructions in Charmcraft | Publish a charm.
If your charm depends on resources, also follow the instructions in Charmcraft | Publish a resource.
Manage tracks and channels¶
Consider whether you need multiple “tracks” for your charm. By default, you’ll have a track called latest, which is intended to correspond to the latest version of your charm’s workload. Some charm developers choose to have a numbered track instead.
If your charm supports multiple workload versions, consider maintaining a track for each major version or major.minor version. See Charmcraft | Manage tracks after publishing your charm.
Charmhub creates four “channels”:
latest/stablelatest/candidatelatest/betalatest/edge
These channels represent different risk levels for users of your charm. Users who deploy from latest/stable expect a production-ready, extensively tested, safe release with release notes. Users who deploy your charm from latest/edge expect to receive a new revision each time you push to your repository’s main branch.
To control which revision of your charm is available from each channel, follow the instructions in Charmcraft | Manage revisions.
Next steps¶
Published charms don’t automatically show up in searches on Charmhub, or general web searches. If your charm is suitable for wider use, you can request public listing. See: