---
title: Charmhub | Deploy Capsule using Charmhub - The Open Operator Collection
description: Deploy the latest version of Capsule as a Kubernetes Operator on any
  cloud.
url: https://charmhub.io/capsule-k8s/docs/usage
---

# Capsule

[Clastix Labs](https://charmhub.io/publisher/clastixlabs "View all packages from Clastix Labs")

* [Clastix Labs](https://charmhub.io/publisher/clastixlabs "View all packages from Clastix Labs")

Platform:

stable 1

```
juju deploy capsule-k8s
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Relevant links

* [Homepage](https://github.com/clastix/capsule-k8s-charm)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

## Usage

### Install

To install the charm, run:

```
# Create dedicated namespace on k8s cluster
juju add-model capsule-system
# Deploy capsule along with the charm operator
juju deploy --trust charm-k8s-capsule
```

### Configure

To configure the charm, run:

```
# Example: juju config capsule-k8s key=value
juju config capsule-k8s force-tenant-prefix=true
juju config capsule-k8s user-groups=capsule.clastix.io,system:serviceaccounts:default
```

In case you have multiple `CapsuleConfiguration` instances, you can modify a specific one by using the `capsule-configuration-name` parameter with the name of the resource you want to modify:

```
juju config capsule-k8s capsule-configuration-name=capsule-configuration-2 force-tenant-prefix=true
```

The configurable parameters are:

| **name** | **description** | type | **default** | references |
| --- | --- | --- | --- | --- |
| `user-groups` | Comma-separated list of user groups (example: `oil.capsule.io,gas.capsule.io`). | string | `capsule.clastix.io` |  |
| `force-tenant-prefix` | Force to have a tenant prefix. | boolean | `false` |  |
| `protected-namespace-regex` | Disallows creation of namespaces matching the passed regexp. | string | `""` |  |

---