Question: How do you configure the shared_buffers size in PostgreSQL?


The shared_buffers configuration parameter in PostgreSQL determines the amount of memory the database server uses for caching data. This cache is used to hold the most frequently accessed blocks of disk-based relation data, which can significantly speed up database operations by reducing disk I/O.

How to Set the shared_buffers Size

The shared_buffers setting can be configured in the postgresql.conf file, which is typically located in your database cluster's data directory. The value can be set in terms of kilobytes (kB), megabytes (MB), or gigabytes (GB).

Here’s an example of how to set shared_buffers to 4GB:

# In postgresql.conf shared_buffers = 4GB

After modifying the postgresql.conf file, you need to restart your PostgreSQL server to apply the changes. You can do this using a command like:

sudo systemctl restart postgresql


pg_ctl restart -D /path/to/your/data/directory

Guidelines for Sizing shared_buffers

  • General Rule: A common recommendation is to set shared_buffers to about 25% of the total system memory dedicated to the database, but not more than about 40% even on systems with a lot of RAM.

  • Small Systems: For smaller systems, such as those with 1-2GB of RAM, you might start with settings like 128MB or 256MB.

  • Large Systems: On larger systems with multiple gigabytes of RAM, settings in the range of 2GB to 8GB are typical.


  • Operating System Caching: PostgreSQL relies on both its own buffer cache as well as the operating system's page cache. Because of this dual caching mechanism, it isn't necessary or advisable to allocate all free memory to shared_buffers.

  • Other Settings: Adjusting shared_buffers is just one part of optimizing PostgreSQL performance. Other parameters like work_mem, maintenance_work_mem, wal_buffers, and effective_cache_size also play crucial roles in the overall performance of your database.

  • Testing and Monitoring: It's important to monitor the impact of changes to shared_buffers on your system's performance. Tools and commands like EXPLAIN ANALYZE for query planning and execution times, and viewing load and memory usage statistics, can help gauge the effectiveness of your settings.

Configuring shared_buffers is a vital step in tuning your PostgreSQL installation, but it should be approached as part of a comprehensive database performance strategy.

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.