diff --git a/config/defaults.hjson b/config/defaults.hjson
index 239caff07..b1e4ff110 100644
--- a/config/defaults.hjson
+++ b/config/defaults.hjson
@@ -8,6 +8,9 @@
     # https://www.postgresql.org/docs/current/libpq-connect.html#id-1.7.3.8.3.6
     connection: "postgres://lemmy:password@localhost:5432/lemmy"
     # Maximum number of active sql connections
+    # 
+    # A high value here can result in errors "could not resize shared memory segment". In this case
+    # it is necessary to increase shared memory size in Docker: https://stackoverflow.com/a/56754077
     pool_size: 30
   }
   # Pictrs image server configuration.
diff --git a/crates/utils/src/settings/structs.rs b/crates/utils/src/settings/structs.rs
index abf01984f..2f12c5b6b 100644
--- a/crates/utils/src/settings/structs.rs
+++ b/crates/utils/src/settings/structs.rs
@@ -153,6 +153,9 @@ pub struct DatabaseConfig {
   pub(crate) connection: String,
 
   /// Maximum number of active sql connections
+  ///
+  /// A high value here can result in errors "could not resize shared memory segment". In this case
+  /// it is necessary to increase shared memory size in Docker: https://stackoverflow.com/a/56754077
   #[default(30)]
   pub pool_size: usize,
 }