2026-09-08 12:34:00 -04:00
---
title : Configure Coder to connect to PostgreSQL using SSL
---
2024-02-24 20:16:56 -05:00
<div>
<a href="https://github.com/ericpaulsen" style="text-decoration: none; color: inherit;">
<span style="vertical-align:middle;">Eric Paulsen</span>
</a>
</div>
February 24, 2024
---
2026-10-15 11:24:40 -04:00
Your organization may require connecting to the database instance over SSL.
To supply Coder with the appropriate certificates, and have it connect over SSL, follow the steps below:
2024-02-24 20:16:56 -05:00
## Client verification (server verifies the client)
2026-10-15 11:24:40 -04:00
1. Create the certificate as a secret in your Kubernetes cluster, if not already present:
2024-02-24 20:16:56 -05:00
2026-07-15 14:07:09 -04:00
```sh
2024-02-24 20:16:56 -05:00
kubectl create secret tls postgres-certs -n coder --key= "postgres.key" --cert= "postgres.crt"
```
1. Define the secret volume and volumeMounts in the Helm chart:
```yaml
coder :
volumes :
- name : "pg-certs-mount"
secret :
secretName : "postgres-certs"
volumeMounts :
- name : "pg-certs-mount"
mountPath : "$HOME/.postgresql"
readOnly : true
```
1. Lastly, your PG connection URL will look like:
2026-07-15 14:07:09 -04:00
```sh
2024-02-24 20:16:56 -05:00
postgres://<user>:<password>@databasehost:<port>/<db-name>?sslmode= require& sslcert = " $HOME /.postgresql/postgres.crt&sslkey= $HOME /.postgresql/postgres.key"
```
## Server verification (client verifies the server)
2026-10-26 20:43:38 -04:00
1. Download the database CA certificate chain and create it as a Kubernetes secret, if not already present:
2024-02-24 20:16:56 -05:00
2026-07-15 14:07:09 -04:00
```sh
2024-02-24 20:16:56 -05:00
kubectl create secret tls postgres-certs -n coder --key= "postgres-root.key" --cert= "postgres-root.crt"
```
1. Define the secret volume and volumeMounts in the Helm chart:
```yaml
coder :
volumes :
- name : "pg-certs-mount"
secret :
secretName : "postgres-certs"
volumeMounts :
- name : "pg-certs-mount"
mountPath : "$HOME/.postgresql/postgres-root.crt"
readOnly : true
```
1. Lastly, your PG connection URL will look like:
2026-07-15 14:07:09 -04:00
```sh
2024-02-24 20:16:56 -05:00
postgres://<user>:<password>@databasehost:<port>/<db-name>?sslmode= verify-full& sslrootcert = "/home/coder/.postgresql/postgres-root.crt"
```
2026-10-15 11:24:40 -04:00
More information on connecting to PostgreSQL databases using certificates can be found in the [PostgreSQL documentation ](https://www.postgresql.org/docs/current/libpq-ssl.html#LIBPQ-SSL-CLIENTCERT ).