diff --git a/README.md b/README.md
index 59cdc63c..c4111295 100644
--- a/README.md
+++ b/README.md
@@ -113,7 +113,7 @@ Environment variables:
 | SOLR_HOST                                    | solr.host                                      | solr                                        |                                                                                                     |
 | SOLR_PORT                                    | solr.port                                      | 8080                                        |                                                                                                     |
 | SOLR_PORT_SSL                                | solr.port.ssl                                  | 8443                                        |                                                                                                     |
-| SOLR_SSL                                     | solr.secureComms                               | https                                       |                                                                                                     |
+| SOLR_SSL                                     | solr.secureComms                               | https                                       | When using value `secret`, the global property environment variable `GLOBAL_solr.sharedSecret=<secret-value>` should be added to this container. The solr should also be configured with the appropriate properties and secret value. |
 | ENABLE_CLUSTERING                            | alfresco.cluster.enabled                       | false                                       |                                                                                                     |
 | TOMCAT_SSL_KEYSTORE                          | encryption.ssl.keystore.location               | /keystore/ssl.keystore                      | Path for the ssl keystore file. Added to both the Tomcat connector and alfresco-global.properties   |
 | TOMCAT_SSL_KEYSTORE_KEY_META_DATA_LOCATION   | encryption.ssl.keystore.keyMetaData.location   | /keystore/keystore-passwords.properties     | Path for the ssl keystore file. Added to both the Tomcat connector and alfresco-global.properties   |
@@ -191,4 +191,4 @@ the repository to build.gradle and add
 -Penterprise
 ```
 
-to your build commands.
\ No newline at end of file
+to your build commands.