diff --git a/README.md b/README.md
index d4bab93..0ffa035 100644
--- a/README.md
+++ b/README.md
@@ -88,7 +88,12 @@ The ports for Redis, PostgreSQL and Unicorn can be overriden in
 ```ruby
 redis['port'] = 1234
 postgresql['port'] = 2345
+
+# due to a bug https://gitlab.com/gitlab-org/omnibus-gitlab/issues/141
+# you have to provide the port for gitlab shell as well,
+# so the 2 following lines have to point to the same port
 unicorn['port'] = 3456
+gitlab_rails['internal_api_url'] = 'http://localhost:3456'
 ```
 
 For Nginx port changes please see the section on enabling HTTPS below.
@@ -531,4 +536,4 @@ This omnibus installer project is based on the awesome work done by Chef in
 [gitlab.yml.erb]: https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/files/gitlab-cookbooks/gitlab/templates/default/gitlab.yml.erb
 [database.yml.postgresql]: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/database.yml.postgresql
 [database.yml.mysql]: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/database.yml.mysql
-[gitlab.yml.example]: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/gitlab.yml.example
+[gitlab.yml.example]: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/gitlab.yml.example
\ No newline at end of file
--
libgit2 0.21.2