.. _ref_commands_register-bundle:

register-bundle
===============

Register a bundle name in the Store.

Claim a name for your bundle in Charmhub. Once you have registered
a name, you can upload bundle packages for that name and
release them for wider consumption.

Charmhub operates on the 'principle of least surprise' with regard
to naming. A bundle with a well-known name should provide the best
system for the service most people associate with that name.  Bundles
can be renamed in the Charmhub, but we would nonetheless ask
you to use a qualified name, such as `yourname-bundlename` if you are
in any doubt about your ability to meet that standard.

We discuss registrations on Charmhub's Discourse:

   https://discourse.charmhub.io/c/charm

Registration will take you through login if needed.


Usage
-----

:command:`charmcraft register-bundle [options] <None>`

Required
--------

``None``
   The name to register in Charmhub.


Global options
--------------

``-h`` or ``--help``
   Show this help message and exit.
``-q`` or ``--quiet``
   Only show warnings and errors, not progress.
``-v`` or ``--verbose``
   Show debug information and be more verbose.
``--verbosity``
   Set the verbosity level to 'quiet', 'brief', 'verbose', 'debug' or 'trace'.
``-V`` or ``--version``
   Show the application version and exit.