Server configuration shot overview

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: oli(dot)sennhauser(at)fromdual(dot)com
Subject: Server configuration shot overview
Date: 2026-07-31 09:38:35
Message-ID: 178549071520.2195443.221949298120586040@wrigleys.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/18/runtime-config.html
Description:

When reading the configuration parameters
(https://www.postgresql.org/docs/current/runtime-config-wal.html) I found it
difficult to find fast the (for me) relevant information: What is the
default? When/how can it be changed? The information is/was always there but
somehow hidden in the text...

So I think it would be more convenient to have these informations summarized
in the beginning?

3 Examples:

synchronous_commit (enum)

--------------|----------
Context | user
Default Value | on
Minimum Value | -
Maximum Value | -
Unit | -
Valid Values | remote_apply, on, remote_write, local, off

Specifies how much WAL processing must complete before...

https://www.postgresql.org/docs/current/runtime-config-wal.html#GUC-SYNCHRONOUS-COMMIT

---

full_page_writes (boolean)

--------------|----------
Context | sighup
Default Value | on
Minimum Value | -
Maximum Value | -
Unit | -
Valid Values | on, off

When this parameter is on, the PostgreSQL server...

https://www.postgresql.org/docs/current/runtime-config-wal.html#GUC-SYNCHRONOUS-COMMIT

---

checkpoint_timeout (integer)

--------------|----------
Context | sighup
Default Value | 300
Minimum Value | 30
Maximum Value | 86400
Unit | s
Valid Values | -

Maximum time between automatic WAL checkpoints...

https://www.postgresql.org/docs/current/runtime-config-wal.html#GUC-CHECKPOINT-TIMEOUT

---

What are other thinking about? Is it worth to take the effort and if yes how
should this be done? All the 400 settings at once (pouhh!) or section by
section?

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message David G. Johnston 2026-07-31 12:20:17 Re: Server configuration shot overview
Previous Message PG Doc comments form 2026-07-31 09:08:31 References/Links missing