---
title: Install spellbook on Linux | Snap Store
description: Get the latest version of spellbook for Linux - Private charm registry
  for Juju and Charmcraft
url: https://snapcraft.io/spellbook
---

# spellbook

[Grégory Schiano (gschiano)](https://snapcraft.io/publisher/gschiano "View all snaps from Grégory Schiano (gschiano)")

* [Grégory Schiano (gschiano)](https://snapcraft.io/publisher/gschiano "View all snaps from Grégory Schiano (gschiano)")
* [Development](https://snapcraft.io/search?categories=development)

latest/edge 0.1

Install latest/edge of spellbook

---

**Install using the command line**

```
sudo snap install spellbook --edge
```

Don't have snapd? [Get set up for snaps](https://snapcraft.io/docs/installing-snapd).

spellbook is only available on the unstable edge channel. It could break and change often.

---

### Package name

* spellbook

---

### License

* Apache-2.0

---

### Last updated

* 24 June 2026 - latest/edge

---

### Source code

* [github.com/gregory-schiano/charm-registry](https://github.com/gregory-schiano/charm-registry "https://github.com/gregory-schiano/charm-registry")

---

### Report a bug

* [github.com/gregory-schiano/charm-registry/issues](https://github.com/gregory-schiano/charm-registry/issues "https://github.com/gregory-schiano/charm-registry/issues")

---

##### Report a Snap Store violation

* [Report this Snap](https://snapcraft.io/spellbook#report-snap-modal)

---

* [Description](https://snapcraft.io/spellbook#tab-description)
* [Security](https://snapcraft.io/spellbook#tab-security)

#### Private charm registry for Juju and Charmcraft

**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
```

---

## Install spellbook on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the [installing snapd documentation](https://snapcraft.io/docs/installing-snapd).

[### Arch Linux](https://snapcraft.io/install/spellbook/arch)

[### CentOS](https://snapcraft.io/install/spellbook/centos)

[### Debian](https://snapcraft.io/install/spellbook/debian)

[### elementary OS](https://snapcraft.io/install/spellbook/elementary)

[### Fedora](https://snapcraft.io/install/spellbook/fedora)

[### KDE Neon](https://snapcraft.io/install/spellbook/kde-neon)

[### Kubuntu](https://snapcraft.io/install/spellbook/kubuntu)

[### Manjaro](https://snapcraft.io/install/spellbook/manjaro)

[### Pop!\_OS](https://snapcraft.io/install/spellbook/pop)

[### openSUSE](https://snapcraft.io/install/spellbook/opensuse)

[### Red Hat Enterprise Linux](https://snapcraft.io/install/spellbook/rhel)

[### Ubuntu](https://snapcraft.io/install/spellbook/ubuntu)