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

# PgBouncer K8s

[Canonical](https://charmhub.io/publisher/data-platform "View all packages from Canonical")

* [Canonical](https://charmhub.io/publisher/data-platform "View all packages from Canonical")
* [Databases](https://charmhub.io/?filter=databases)

Platform:

1/stable 593

```
juju deploy pgbouncer-k8s --channel 1/stable --trust
```

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

---

#### Relevant links

* [Homepage](https://ubuntu.com/data/postgresql)

---

#### Contacts

##### Maintainers

+ [Canonical Data Platform](mailto:data-platform@lists.launchpad.net)

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

---

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

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

# Tutorial

This section of our documentation contains a hands-on tutorial to help you learn how to deploy Charmed PgBouncer together with PostgreSQL on Kubernetes, and become familiar with some of its operations.

## [Prerequisites](https://charmhub.io/pgbouncer-k8s/docs/tutorial#p-28298-prerequisites)

While this tutorial intends to guide you as you deploy Charmed PgBouncer K8s for the first time, it will be most beneficial if:

* You have some experience using a Linux-based CLI
* You are familiar with PgBouncer concepts such as load balancing and connection pooling.
* Your computer fulfils the [minimum system requirements](https://charmhub.io/pgbouncer-k8s/docs/r-requirements)

## [Tutorial contents](https://charmhub.io/pgbouncer-k8s/docs/tutorial#p-28298-tutorial-contents)

This Charmed PgBouncer K8s tutorial has the following parts:

| Step | Details |
| --- | --- |
| 1. [**Set up the environment**](https://charmhub.io/pgbouncer-k8s/docs/t-setup-environment) | Set up a cloud environment for your deployment using [Multipass](https://multipass.run/) with [MicroK8s](https://microk8s.io/docs) and [Juju](https://juju.is/). |
| 2. [**Deploy PgBouncer**](https://charmhub.io/pgbouncer-k8s/docs/t-deploy-charm) | Learn to deploy Charmed PgBouncer with Juju |
| 3. [**Manage your units**](https://charmhub.io/pgbouncer-k8s/docs/t-managing-units) | Learn how to scale PgBouncer units |
| 4. [**Enable security with TLS**](https://charmhub.io/pgbouncer-k8s/docs/t-enable-security) | Learn how to enable TLS encryption in PgBouncer traffic |
| 5. [**Clean up the environment**](https://charmhub.io/pgbouncer-k8s/docs/t-cleanup-environment) | Free up your machine’s resources |

---