On this page


PostgreSQL is an object-relational database management system (ORDBMS) with an emphasis on extensibility and on standards-compliance.


The version currently installed by the add-on is :

  • on shared plans (DEV) : PostgreSQL 11
  • on newly created dedicated databases (plans XS Small Space and above) : PostgreSQL 10, 11, 12, 13, 14

Database Daily Backup and Retention

By default, Clever Cloud performs a free backup every day, with a retention of seven days. Retention and frequency can be customized for Premium customers.

Each backup can be found in the add-on dashboard in the web console, along with the credentials.

Migrating from an old database

Some applications require a populated database to run properly. If you want to import your SQL dump, you can use several methods:

  1. Our WebGUI (Adminer).
  2. Command line tool for PostgreSQL administration like psql.
  3. Any PostgreSQL client such as pgAdmin.

Direct access

All our dedicated PostgreSQL databases are served via a proxy. To reduce the latency you can bypass this proxy by generating direct hostname and port for the addon. You can do it by clicking the “Generate direct hostname and port” on the addon dashboard.

This action will add new environment variables to reach the addon without any proxy.

Keep in mind that usage of direct access is a trade-off: when you migrate your addon, you will need to to generate hostname and port again so your application must update these environment while proxy usage changes nothing.

Encryption at rest

Encryption at rest is available on PostgreSQL. You can have more information on the dedicated page

Note on shared databases

Free databases are instantiated from a shared cluster. The way postgresql works on shared clusters is that a “pg_database” table references the name, and only the name, of other databases in that same cluster. The data, on the other hand, is not accessible.

This referencing does not exist for dedicated databases.


Pgpool-II is a proxy software that sits between PostgreSQL servers and a PostgreSQL database client.

You can read the official project page for more information.

You can learn more about Pgpool-II on the dedicated documentation page

Default extensions

Every PostgreSQL database managed by Clever Cloud comes with the following default extensions: adminpack, autoinc, btree_gin, btree_gist, citext, cube, dblink, dict_int, dict_xsyn, earthdistance, file_fdw, fuzzystrmatch, hstore, insert_username, intagg, intarray, isn, lo, ltree, moddatetime, pageinspect, pg_buffercache, pgcrypto, pg_freespacemap, pgrowlocks, pg_stat_statements, pgstattuple, pg_trgm, plcoffee, plls, plv8, postgis, postgis_tiger_geocoder, postgis_topology postgres_fdw, refint, seg, sslinfo, tablefunc, tcn, timetravel, unaccent, "uuid-ossp", xml2

Automatic vacuuming

Autovacuum is automatically enabled on PostgreSQL add-ons.
The autovacuum will proceed when a given percentage of rows of a table will be updated/inserted/deleted.
Usually this threshold is set to 20%.


If you want to use pg_activity on an PostgreSQL addon but you get an Exception: Must be run with database superuser privileges. you need to add the flag --rds when you start it.