For package management
rebar3 uses hex.pm, a package manager for Erlang and Elixir packages. For instructions on publishing your package see the Publishing Packages tutorial. Below is an entry for each subtask of the
hex namespace and what it does.
Reads or updates hex configuration file.
Hex API key
Hex API base URL
Hex CDN base URL
HTTP proxy server
HTTPS proxy server
Increment version number and publish package.
You'll be asked what type of increment to make to the version or it can be supplied as an argument to the command
Publishes documentation for the current project and version.
The documentation will be accessible at
http://hexdocs.pm/my_package will always redirect to the latest published version.
Documentation will be generated by running the
rebar3 hex docs task, which publishes documentation it generates through
docs provides this task by default, but any library can be used. Or an alias can be used to extend the documentation generation. The expected result of the task is the generated documentation located in the
docs/ directory with an
Prints hex package or system information.
package is not given, print system information. This includes when registry was last updated and current system version.
package is given, print information about the package. This includes all released versions and package metadata.
package and version is given print release information. This includes remote Git URL and Git ref, and all package dependencies.
Remove or list API keys associated with your account.
Remove given API key from account. The key can no longer be used to authenticate API requests.
rebar3 hex key remove <key_name>
List all API keys associated with your account.
rebar3 hex key list
Publish a new version of your package and update the package.
rebar3 hex publish
If it is a new package being published it will be created and the user specified in
username will be the package owner. Only package owners can publish.
A published version can be amended or reverted with
--revert up to one hour after its publication. If you want to revert a publication that is more than one hour old you need to contact an administrator.
Add, remove or list package owners.
A package owner have full permissions to the package. They can publish and revert releases and even remove other package owners.
Add an owner to package by specifying the package name and email of the new owner.
rebar3 hex owner add <package> <email>
Remove an owner to package by specifying the package name and email of the new owner.
`rebar3 hex owner remove
List all owners of given package.
rebar3 hex owner list <package>
Hex user tasks.
rebar3 hex user register
rebar3 hex user whoami
Authorizes a new user on the local machine by generating a new API key and storing it in the hex config.
rebar3 hex user auth
Deauthorizes the user from the local machine by removing the API key from the hex config.
rebar3 hex user deauth
rebar3 hex user reset_password
Display packages matching the given search query.
rebar3 hex search <term>
Updated 3 years ago