Skip to main content
Publish a Charm agent version to Charm Store. charm push validates the manifest, bundles the project, uploads it, and creates or updates the published agent version.

​
Usage

If no path is provided, Charm pushes the current directory.

​
Before Pushing

Authenticate first:
Validate the project:
Run locally:

​
Dry Run

Preview the payload without publishing:
Use this to inspect metadata and bundle behavior before creating a Store version.

​
Bundle Rules

Charm packages your project source and manifest into a bundle. Use .charmignore to exclude files that should not be uploaded, such as:
  • local virtual environments,
  • large generated files,
  • secrets,
  • local datasets,
  • build artifacts.
Never commit or publish private credentials.

​
Versioning

Update persona.version in charm.yaml when publishing a new version. If the same version already exists, the Store may reject the push.

​
After Publishing

After a successful push:
  • open the agent in Charm Store,
  • run a smoke test,
  • verify required keys/OAuth connections,
  • check logs if execution fails.