---
title: Charmhub | Deploy SAML Integrator using Charmhub - The Open Operator Collection
description: Deploy the latest version of SAML Integrator on any cloud.
url: https://charmhub.io/saml-integrator/docs/tutorial-getting-started
---

# SAML Integrator

[Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

* [Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

Platform:

22.04

20.04

stable 66

```
juju deploy saml-integrator
```

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

---

#### Contacts

##### Maintainers

+ [Launchpad Team](https://launchpad.net/~canonical-is-devops)

* [Submit a bug](https://github.com/canonical/saml-integrator-operator/issues)

---

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

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

# Getting started

In this tutorial, we’ll walk you through the process of deploying the SAML Integrator charm. We’ll be deploying the charm on top of Kubernetes although a machine substrate could also be used.

## [Requirements](https://charmhub.io/saml-integrator/docs/tutorial-getting-started#p-27193-requirements)

You will need:

* A laptop or desktop running Ubuntu (or you can use a VM).
* [Juju and MicroK8s](https://juju.is/docs/olm/microk8s) installed.

## [Deploy this charm](https://charmhub.io/saml-integrator/docs/tutorial-getting-started#p-27193-deploy-this-charm)

The charm will the deployed in a new model named `saml-tutorial`:

```
# Add the model
juju add-model saml-tutorial

# Deploy the charm
juju deploy saml-integrator

# Provide the mandatory configurations
juju config saml-integrator metadata_url=https://login.staging.ubuntu.com/saml/metadata
juju config saml-integrator entity_id=https://login.staging.ubuntu.com
```

By running `juju status --relations` the current state of the deployment can be queried, with the charm eventually reaching `Active` state:

```
Model           Controller          Cloud/Region        Version  SLA          Timestamp
saml-tutorial   microk8s-localhost  microk8s/localhost  2.9.44   unsupported  12:54:25+02:00

App              Version  Status  Scale  Charm            Channel  Rev  Address        Exposed  Message
saml-integrator           active      1  saml-integrator             0  10.152.183.65  no

Unit                Workload  Agent  Address     Ports  Message
saml-integrator/0*  active    idle   10.1.57.14
```

Run `kubectl get pods -n saml-tutorial` to see the pods that are being created by the charms:

```
NAME                            READY   STATUS    RESTARTS   AGE
modeloperator-d465f6695-zvhk8   1/1     Running   0          2m33s
saml-integrator-0               1/1     Running   0          99s
```

---