# Install

## Install Rook Ceph

In this part, you create a Rook Ceph Cluster by installing Rook Ceph as a custom add-on through a cluster blueprint.

---

### Step 1: Create Namespace

You will now create a managed namespace from the controller for Rook Ceph.

- Navigate to **Infrastructure -> Namespaces**  
- Click on **New Namespace**  
- Enter the name **rook-ceph** and select type as **Wizard**  
- Click **Save**

- Click **Save & Go To Placement**  
- Select one of your clusters for placement  
- Click **Save & Go To Publish**  
- Click **Publish**  
- Click **Exit**

---

### Step 2: Create the Rook Ceph Operator add-on

In this step, you will create a custom cluster add-on from the Catalog for the Rook Ceph Operator. The add-on will then be used in a custom cluster blueprint.

- Navigate to **Infrastructure -> Add-Ons**  
- Click **New Add-On -> Create New Add-On from Catalog**  
- Search for **rook**

- Click **rook-ceph**  
- Click **Create Add-On**  
- Enter the name **rook-operator** and select the namespace **rook-ceph** created as part of the previous step  
- Click **Create**

- Enter **v1** for the version name  
- Select the helm chart version to be used  
- If needed, provide an override values file for the helm chart  
- Click **Save Changes**

---

### Step 3: Create the Rook Ceph Cluster add-on

In this step, you will create a custom cluster add-on from the Catalog for the Rook Ceph Cluster. The add-on will then be used in a custom cluster blueprint.

- Navigate to **Infrastructure -> Add-Ons**  
- Click **New Add-On -> Create New Add-On from Catalog**  
- Search for **rook**

- Click **rook-ceph-cluster**  
- Click **Create Add-On**  
- Enter the name **rook-cluster** and select the namespace **rook-ceph** created as part of a previous step  
- Click **Create**

- Enter **v1** for the version name  
- Select the helm chart version to be used  
- Save the following to a file named **cluster-values.yaml**

```
toolbox:
  enabled: true
```

- Click **Upload Files** and select the previously saved YAML file  
- Click **Save Changes**

---

### Step 4: Create Blueprint

In this step, you will create a custom cluster blueprint which contains the previously created add-ons.

- Navigate to **Infrastructure -> Blueprints**  
- Click **New Blueprint**  
- Provide a name (e.g. rook-ceph), select type as **Custom Blueprint**  
- Click **Save**

- Enter **v1** for the version name  
- Select **minimal** for the base blueprint  
- Click **Configure Add-Ons**  
- Click the **+** symbol to add the **rook-operator** and the **rook-cluster** add-ons to the blueprint  
- Add the **rook-operator** as a dependency to the **rook-cluster** add-on  
- Click **Save Changes**

- Click **Save Changes** again

---

### Step 5: Apply Blueprint

In this step, you will apply the previously created blueprint to the cluster. Applying the blueprint will install the Rook Ceph components.

- Navigate to **Infrastructure -> Clusters**  
- Click the gear icon on your cluster  
- Select **Update Blueprint**  
- Select the blueprint created as part of the previous step (e.g. rook-ceph) and **v1** for the version  
- Click **Save and Publish**

- Click **Exit**

---

## Recap

Congratulations! You have successfully created a custom cluster blueprint with Rook Ceph as a custom add-on. You can now use this blueprint on as many clusters as you require to provide distributed storage to your applications.