diff --git a/images/docker-unifi-controller.md b/images/docker-unifi-controller.md
index d2809ae56b..ede6601311 100644
--- a/images/docker-unifi-controller.md
+++ b/images/docker-unifi-controller.md
@@ -37,6 +37,7 @@ docker create \
   --name=unifi-controller \
   -e PUID=1000 \
   -e PGID=1000 \
+  -e MEM_LIMIT=1024M `#optional` \
   -p 3478:3478/udp \
   -p 10001:10001/udp \
   -p 8080:8080 \
@@ -80,6 +81,7 @@ services:
     environment:
       - PUID=1000
       - PGID=1000
+      - MEM_LIMIT=1024M #optional
     volumes:
       - <path to data>:/config
     ports:
@@ -118,6 +120,7 @@ Docker images are configured using parameters passed at runtime (such as those a
 | :----: | --- |
 | `PUID=1000` | for UserID - see below for explanation |
 | `PGID=1000` | for GroupID - see below for explanation |
+| `MEM_LIMIT=1024M` | Optionally change the Java memory limit (-Xmx) (default is 1024M). |
 
 ### Volume Mappings (`-v`)
 
@@ -171,5 +174,6 @@ Use `ubnt` as the password to login and `$address` is the IP address of the host
 
 ## Versions
 
+* **29.07.19:** - Allow for changing Java mem limit via new optional environment variable.
 * **23.03.19:** - Switching to new Base images, shift to arm32v7 tag.
 * **10.02.19:** - Initial release of new unifi-controller image with new tags and pipeline logic