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

# PgBouncer

[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:

24.04

22.04

20.04

18.04

16.04

1/stable 1092

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

[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-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 machines and become familiar with some of its operations.

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

While this tutorial intends to guide you as you deploy Charmed PgBouncer 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/docs/r-requirements)

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

This Charmed PgBouncer tutorial has the following parts:

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

---