Summary
Private charm registry for Juju and Charmcraft
Description
Charm Registry is a private charm registry compatible with stock Juju and Charmcraft workflows. It exposes Charmhub-compatible APIs and includes an embedded OCI registry for image resources.
Install and configure
sudo snap install spellbook
sudo snap set spellbook oci.secret-key="$(openssl rand -hex 32)"
sudo snap start spellbook
The snap defaults to standalone mode using SQLite and filesystem storage under /var/snap/spellbook/common/data/.
Useful commands
snap services spellbook
sudo snap logs spellbook.charm-registry
snap get spellbook
sudo snap restart spellbook
Configure public URLs
sudo snap set spellbook public-api-url=http://registry.example.com:8080
sudo snap set spellbook public-storage-url=http://registry.example.com:8080
sudo snap set spellbook public-registry-url=https://registry.example.com:5000
For production, configure OIDC, admin identities, TLS, and durable storage such as PostgreSQL and S3-compatible object storage.
By default a self-signed certificate is generated, when using the registry with charmcraft or juju you'll have to add this certificate to the trust store:
sudo cp /var/snap/charm-registry/common/certs/oci.crt /usr/local/share/ca-certificates/charm-registry-oci.crt
sudo update-ca-certificates
Admin CLI
spellbook.charm-registryctl --url https://registry.example.com:8080 --token "<admin-token>" sync list
You are about to open
Do you wish to proceed?
Thank you for your report. Information you provided will help us investigate further.
There was an error while sending your report. Please try again later.
Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.
Snaps are discoverable and installable from the Snap Store, an app store with an audience of millions.
If you’re running Ubuntu 16.04 LTS (Xenial Xerus) or later, including Ubuntu 18.04 LTS (Bionic Beaver) and Ubuntu 20.04 LTS (Focal Fossa), you don’t need to do anything. Snap is already installed and ready to go.
For versions of Ubuntu between 14.04 LTS (Trusty Tahr) and 15.10 (Wily Werewolf), as well as Ubuntu flavours that don’t include snap by default, snap can be installed from the Ubuntu Software Centre by searching for snapd.
Alternatively, snapd can be installed from the command line:
sudo apt update
sudo apt install snapd
Either log out and back in again, or restart your system, to ensure snap’s paths are updated correctly.
To install spellbook, simply use the following command:
sudo snap install spellbook --edge
Browse and find snaps from the convenience of your desktop using the snap store snap.
Interested to find out more about snaps? Want to publish your own application? Visit snapcraft.io now.