diff --git a/README.md b/README.md
index 209a5fbb..19473203 100644
--- a/README.md
+++ b/README.md
@@ -353,6 +353,7 @@ services:
       - 8080:8080
       - 8181:8181
       - 8081:8081
+    shm_size: "1gb"
     restart: unless-stopped
 ```
 
@@ -371,6 +372,7 @@ docker run -d \
   -p 8181:8181 \
   -p 8081:8081 \
   -v /path/to/calibre/config:/config \
+  --shm-size="1gb" \
   --restart unless-stopped \
   lscr.io/linuxserver/calibre:latest
 ```
@@ -390,6 +392,7 @@ Containers are configured using parameters passed at runtime (such as those abov
 | `-e PASSWORD=` | Optionally set a password for the gui. |
 | `-e CLI_ARGS=` | Optionally pass cli start arguments to calibre. |
 | `-v /config` | Where calibre should store its database and library. |
+| `--shm-size=` | Recommended for all desktop images. |
 | `--security-opt seccomp=unconfined` | For Docker Engine only, many modern gui apps need this to function as syscalls are unkown to Docker. |
 
 ## Environment variables from files (Docker secrets)
diff --git a/readme-vars.yml b/readme-vars.yml
index b793c159..7d6c7a30 100644
--- a/readme-vars.yml
+++ b/readme-vars.yml
@@ -36,6 +36,8 @@ opt_param_env_vars:
 opt_security_opt_param: true
 opt_security_opt_param_vars:
   - {run_var: "seccomp=unconfined", compose_var: "seccomp:unconfined", desc: "For Docker Engine only, many modern gui apps need this to function as syscalls are unkown to Docker."}
+custom_params:
+  - {name: "shm-size", name_compose: "shm_size", value: "1gb", desc: "Recommended for all desktop images."}
 # Selkies blurb settings
 selkies_blurb: true
 external_http_port: "8080"