Skip to content

Commit ad8ff8a

Browse files
skjnldsvclaude
andcommitted
fix: replace overflowing list-table with definition list for pm modes
The list-table with widths 15/85 caused horizontal overflow in the rendered HTML. Definition list avoids the issue and is more idiomatic RST for key-value mode descriptions. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
1 parent 5e0c688 commit ad8ff8a

1 file changed

Lines changed: 16 additions & 20 deletions

File tree

admin_manual/installation/server_tuning.rst

Lines changed: 16 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -149,26 +149,22 @@ Process manager modes
149149

150150
The ``pm`` directive controls how PHP-FPM manages its worker processes:
151151

152-
.. list-table::
153-
:header-rows: 1
154-
:widths: 15 85
155-
156-
* - Mode
157-
- Behaviour
158-
* - ``dynamic``
159-
- Keeps between ``pm.min_spare_servers`` and ``pm.max_spare_servers`` idle workers alive,
160-
up to a ceiling of ``pm.max_children``. Good default for most Nextcloud installations:
161-
balances RAM efficiency with burst capacity. Set ``pm.min_spare_servers`` high enough
162-
that sync-client poll bursts do not stall waiting for new processes to spawn.
163-
* - ``static``
164-
- Always keeps exactly ``pm.max_children`` processes running. Highest memory use,
165-
lowest latency. Use on dedicated servers with predictable load. Always set
166-
``pm.max_requests`` to recycle workers and prevent memory leaks.
167-
* - ``ondemand``
168-
- Spawns a worker only when a request arrives; kills idle workers after
169-
``pm.process_idle_timeout`` (default ``10s``). Lowest memory use but adds
170-
cold-start latency on every burst. Not recommended for Nextcloud: desktop and
171-
mobile clients poll every 30 seconds, repeatedly triggering cold starts.
152+
``dynamic``
153+
Keeps between ``pm.min_spare_servers`` and ``pm.max_spare_servers`` idle workers alive,
154+
up to a ceiling of ``pm.max_children``. Good default for most Nextcloud installations:
155+
balances RAM efficiency with burst capacity. Set ``pm.min_spare_servers`` high enough
156+
that sync-client poll bursts do not stall waiting for new processes to spawn.
157+
158+
``static``
159+
Always keeps exactly ``pm.max_children`` processes running. Highest memory use,
160+
lowest latency. Use on dedicated servers with predictable load. Always set
161+
``pm.max_requests`` to recycle workers and prevent memory leaks.
162+
163+
``ondemand``
164+
Spawns a worker only when a request arrives; kills idle workers after
165+
``pm.process_idle_timeout`` (default ``10s``). Lowest memory use but adds
166+
cold-start latency on every burst. Not recommended for Nextcloud: desktop and
167+
mobile clients poll every 30 seconds, repeatedly triggering cold starts.
172168

173169
Key parameters
174170
^^^^^^^^^^^^^^

0 commit comments

Comments
 (0)