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.
Snap can be installed from the command line on openSUSE Leap 15.x and Tumbleweed.
You need first add the snappy repository from the terminal. Choose the appropriate command depending on your installed openSUSE flavor.
Tumbleweed:
sudo zypper addrepo --refresh https://download.opensuse.org/repositories/system:/snappy/openSUSE_Tumbleweed snappy
Leap 15.x:
sudo zypper addrepo --refresh https://download.opensuse.org/repositories/system:/snappy/openSUSE_Leap_15.6 snappy
If needed, Swap out openSUSE_Leap_15. for, openSUSE_Leap_16.0 if you’re using a different version of openSUSE.
With the repository added, import its GPG key:
sudo zypper --gpg-auto-import-keys refresh
Finally, upgrade the package cache to include the new snappy repository:
sudo zypper dup --from snappy
Snap can now be installed with the following:
sudo zypper install snapd
You then need to either reboot, logout/login or source /etc/profile to have /snap/bin added to PATH.
Additionally, enable and start both the snapd and the snapd.apparmor services with the following commands:
sudo systemctl enable --now snapd
sudo systemctl enable --now snapd.apparmor
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.