# postgresql-bundle

**Repository Path**: mirrors_canonical/postgresql-bundle

## Basic Information

- **Project Name**: postgresql-bundle
- **Description**: Canonical bundle of PostgreSQL + PgBouncer for machines
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-10-24
- **Last Updated**: 2026-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PostgreSQL Bundle
[![Charmhub](https://charmhub.io/postgresql-bundle/badge.svg)](https://charmhub.io/postgresql-bundle)
[![Release](https://github.com/canonical/postgresql-bundle/actions/workflows/release.yaml/badge.svg)](https://github.com/canonical/postgresql-bundle/actions/workflows/release.yaml)
[![Tests](https://github.com/canonical/postgresql-bundle/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/canonical/postgresql-bundle/actions/workflows/ci.yaml)

A juju bundle for deploying PostgreSQL and PGBouncer machine charms, with TLS enabled by default. For kubernetes, see the [postgresql-k8s-bundle](https://github.com/canonical/postgresql-k8s-bundle).

Included charms:
- [postgresql-operator](https://github.com/canonical/postgresql-operator)
  - 2 replica units
  - related to pgbouncer-operator for connection pooling
  - related to tls-certificates-operator for TLS.
- [pgbouncer-operator](https://github.com/canonical/pgbouncer-operator)
  - Note: TLS not implemented in this proxy yet
- [tls-certificates-operator](https://github.com/canonical/tls-certificates-operator)
  - The TLS implementation is self-signed - if other certificates are required, please follow the [TLS Certificate Operator Documentation](https://charmhub.io/tls-certificates-operator) to upload your own.

## Deployment

To deploy in a VM juju model:
```bash
juju deploy postgresql-bundle
juju add-relation pgbouncer:database my-app:backend-database
```

## License

The Charmed PostgreSQL Bundle is free software, distributed under the Apache Software License, version 2.0. See [LICENSE](https://github.com/canonical/pgbouncer-operator/blob/main/LICENSE) for more information.

## Security

Security issues in this bundle can be reported through [LaunchPad](https://wiki.ubuntu.com/DebuggingSecurity#How%20to%20File). Please do not file GitHub issues about security issues.

## Contributing

Please see the [Juju SDK docs](https://juju.is/docs/sdk) for guidelines on enhancements to this charm following best practice guidelines, and [CONTRIBUTING.md](https://github.com/canonical/postgresql-bundle/CONTRIBUTING.md) for developer guidance. For more information, get in touch on the [Charmhub Mattermost server](https://chat.charmhub.io).