Skip to content

Commit 3af6cd6

Browse files
authored
Add explicit recommendation to use NVMe / SSD for DB storage (#188)
Signed-off-by: nscuro <nscuro@protonmail.com>
1 parent 3a87f7a commit 3af6cd6

2 files changed

Lines changed: 9 additions & 0 deletions

File tree

docs/guides/administration/configuring-database.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,11 @@ without being impacted by other applications.
5252

5353
For smaller and non-critical deployments, it is totally fine to run everything on a single machine.
5454

55+
**You should use fast disks for storage**, ideally NVME, but at the very least SSDs. Unless your entire working
56+
set fits into memory, PostgreSQL needs to perform random disk access, which is slow on HDDs due to seek latency.
57+
Local disks give you the most predictable performance. Network-attached storage also works well, provided you
58+
provision guaranteed IOPS and avoid tiers that throttle throughput under sustained load.
59+
5560
#### Upgrades
5661

5762
Follow the [official upgrading guide]. Be sure to select the version of the documentation that corresponds to the

docs/guides/administration/deploying-to-production.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,10 @@ Run the database on a dedicated host. Co-locating PostgreSQL with API server ins
5050
compete for the same CPU, memory, and I/O, and that contention surfaces as unpredictable latency under
5151
load.
5252

53+
Use fast disks, ideally NVME but at least SSDs. Once the working set outgrows memory,
54+
PostgreSQL falls back to random disk access, which HDDs handle poorly.
55+
See [Configuring the database](configuring-database.md) for storage guidance.
56+
5357
When sizing the database host, account for the per-instance connection pool. PostgreSQL's `max_connections`
5458
must cover the sum of all pools across the cluster, plus headroom for migrations, backups, and
5559
administrator sessions:

0 commit comments

Comments
 (0)