diff --git a/README.md b/README.md
index dd5fc3723ef82d3283c8a1048b11241dfb1575e9..37b0d56a358565f114601adf9d5709cf2827af38 100644
--- a/README.md
+++ b/README.md
@@ -23,3 +23,7 @@ The initial admin login is user ```root```.  The password can be obtained with t
 ```
 kubectl get secret gitlab-gitlab-initial-root-password -n gitlab -ojsonpath='{.data.password}' | base64 --decode ; echo
 ```
+
+##  Deployment
+
+For production deployments you must externalize the postgres and MinIO services. See docs/README.md.
\ No newline at end of file
diff --git a/docs/README.md b/docs/README.md
index f5f0519b32dba59437846ab035255515250aa9d1..3abcefff6bf62f8717b8477eecfb123d18b1799b 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -13,6 +13,28 @@
 
 GitLab is a web-based DevOps lifecycle tool that provides a Git-repository manager providing wiki, issue-tracking and continuous integration/continuous deployment pipeline features, using an open-source license, developed by GitLab Inc.
 
+## Application Deployment
+
+For production deployments you must externalize the postgres and MinIO services. You should disable the internal postgres and enable RDS for the database in the values.yaml
+```
+postgresql:
+  install: false
+```
+and customize the values.yaml for your RDS credentials
+```
+ ## doc/charts/globals.md#configure-postgresql-settings
+  psql:
+    password: {}
+      # secret:
+      # key:
+    # host: postgresql.hostedsomewhere.else
+    # port: 123
+    # username: gitlab
+    # database: gitlabhq_production
+    # pool: 1
+    # preparedStatements: false
+```
+
 
 ## Keycloak SSO integration