Question: What is the shared_buffers configuration in PostgreSQL?


PostgreSQL's shared_buffers parameter is a crucial setting that determines the amount of memory the database server will use for caching data. This cache is shared among all connections to the database, and it can significantly affect the performance of your PostgreSQL server.

The shared_buffers value is specified in the postgresql.conf file or can be altered on-the-fly with the ALTER SYSTEM command, followed by reloading the configuration. It's generally recommended that this value be set to around 25% to 40% of the total system memory on dedicated database servers, but the optimal setting can vary based on your workload and hardware.

How to View the Current Setting

You can view the current setting of shared_buffers by running:

SHOW shared_buffers;

How to Set shared_buffers

To change the value, you would typically edit postgresql.conf:

shared_buffers = '4GB' # For example, on a server with 16GB of RAM

After editing the configuration file, you must reload the PostgreSQL configuration for changes to take effect:

pg_ctl reload

Or from within SQL:

SELECT pg_reload_conf();


  • Changing shared_buffers requires a restart of the PostgreSQL service if done through the configuration file.
  • On systems with a large amount of RAM, setting shared_buffers to a very high value may not always yield better performance due to how PostgreSQL utilizes OS cache.
  • Testing different settings under your specific workload is crucial for determining the best value.
  • Be mindful of other applications running on the same server, as they also require memory. Allocating too much memory to PostgreSQL could negatively impact overall system performance.

In summary, shared_buffers is a key performance tuning parameter in PostgreSQL. Its optimal size depends on many factors including your system's total memory, the nature of your workloads, and the overall system configuration.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book
Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.