The main tool to build, upload, and develop in general the Juju charms.
Project description
Charmcraft
Charmcraft is the command-line tool for initializing, packaging, and publishing charms, the software operators used by Juju. With Charmcraft, you can bypass the boilerplate steps of crafting a charm and focus on what matters — building scalable, configurable, and easy-to-deploy applications for Juju.
Basic usage
Charmcraft provides commands to streamline every step of the charm development process, from initializing your charm project to releasing it on Charmhub.
In your project's root directory, initialize your charm project with basic template content by running:
charmcraft init
Once you've configured your project to suit the needs of the application you're charming, build the charm by running:
charmcraft pack
If you're ready to distribute your charm, you can register its name on Charmhub with:
charmcraft register
Upload your charm and any subsequent revisions to Charmhub with:
charmcraft upload
Installation
Charmcraft is available on all major Linux distributions and macOS.
The recommended way to install Charmcraft on Linux systems is through its snap.
sudo snap install charmcraft --classic
For information on installing Charmcraft on other platforms, refer to our installation guide.
Documentation
The Charmcraft documentation provides guidance and learning materials for every step of the charming process. Whether you're new to charming or a seasoned expert, this is the best place to deepen your knowledge.
Community and support
To get in touch with developers and other charmcraft-badge: https://snapcraft.io/charmcraft/badge.svg charmcraft-site: https://snapcraft.io/charmcraft members of the charming community, reach out on the forum or in our Matrix channel.
You can report any issues or bugs on the project's GitHub repository.
Charmcraft is covered by the Ubuntu Code of Conduct.
Contribute to Charmcraft
Charmcraft is open source and part of the Canonical family. We would love your help.
If you're interested, start with the contribution guide.
We welcome any suggestions and help with the docs. The Canonical Open Documentation Academy is the hub for doc development, including Charmcraft docs. No prior coding experience is required.
License and copyright
Charmcraft is released under the Apache-2.0 license
© 2023-2025 Canonical Ltd.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file charmcraft-4.2.2.tar.gz.
File metadata
- Download URL: charmcraft-4.2.2.tar.gz
- Upload date:
- Size: 1.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f6de6e6ae87fa60a8a4e88c367feb0df5afcadc7c14b79b0fa41205aabeb6f8
|
|
| MD5 |
98f2e94def42c796f5e24c1ff58721d3
|
|
| BLAKE2b-256 |
0dc7177e92ac146923b39de80a8e036e41ce88390aa0cc221ec7b1c8583bb5b0
|
Provenance
The following attestation bundles were made for charmcraft-4.2.2.tar.gz:
Publisher:
release-publish.yaml on canonical/charmcraft
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
charmcraft-4.2.2.tar.gz -
Subject digest:
3f6de6e6ae87fa60a8a4e88c367feb0df5afcadc7c14b79b0fa41205aabeb6f8 - Sigstore transparency entry: 1912111442
- Sigstore integration time:
-
Permalink:
canonical/charmcraft@b5334d9b2a81bc120cf47d176e9d08d9f2fca0b8 -
Branch / Tag:
refs/tags/4.2.2 - Owner: https://github.com/canonical
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
self-hosted -
Publication workflow:
release-publish.yaml@b5334d9b2a81bc120cf47d176e9d08d9f2fca0b8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file charmcraft-4.2.2-py3-none-any.whl.
File metadata
- Download URL: charmcraft-4.2.2-py3-none-any.whl
- Upload date:
- Size: 272.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c91d88d8c66325a12c1a5450d8deae9c83bdc7a57ac36826dba289ae79844287
|
|
| MD5 |
97897b358dbf780a846689f6371b7530
|
|
| BLAKE2b-256 |
6c19f49f989aaad97059801dd7b2aca3b59b31c552fb877ff688d99f5dddd305
|
Provenance
The following attestation bundles were made for charmcraft-4.2.2-py3-none-any.whl:
Publisher:
release-publish.yaml on canonical/charmcraft
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
charmcraft-4.2.2-py3-none-any.whl -
Subject digest:
c91d88d8c66325a12c1a5450d8deae9c83bdc7a57ac36826dba289ae79844287 - Sigstore transparency entry: 1912111633
- Sigstore integration time:
-
Permalink:
canonical/charmcraft@b5334d9b2a81bc120cf47d176e9d08d9f2fca0b8 -
Branch / Tag:
refs/tags/4.2.2 - Owner: https://github.com/canonical
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
self-hosted -
Publication workflow:
release-publish.yaml@b5334d9b2a81bc120cf47d176e9d08d9f2fca0b8 -
Trigger Event:
push
-
Statement type:
