diff --git a/doc/ci/services/mysql.md b/doc/ci/services/mysql.md
index 44bc613e6f7..c66d77122b2 100644
--- a/doc/ci/services/mysql.md
+++ b/doc/ci/services/mysql.md
@@ -24,12 +24,15 @@ variables:
 And then configure your application to use the database, for example:
 
 ```yaml
-Host: localhost
+Host: mysql
 User: root
 Password: mysql_strong_password
 Database: el_duderino
 ```
 
+If you are wondering why we used `mysql` for the `Host`, read more at
+[How is service linked to the build](../docker/using_docker_images.md#how-is-service-linked-to-the-build).
+
 You can also use any other docker image available on [Docker Hub][hub-mysql].
 For example, to use MySQL 5.5 the service becomes `mysql:5.5`.
 
diff --git a/doc/ci/services/postgres.md b/doc/ci/services/postgres.md
index db5be070ee7..17d21dbda1c 100644
--- a/doc/ci/services/postgres.md
+++ b/doc/ci/services/postgres.md
@@ -24,12 +24,15 @@ variables:
 And then configure your application to use the database, for example:
 
 ```yaml
-Host: localhost
+Host: postgres
 User: runner
 Password:
 Database: nice_marmot
 ```
 
+If you are wondering why we used `postgres` for the `Host`, read more at
+[How is service linked to the build](../docker/using_docker_images.md#how-is-service-linked-to-the-build).
+
 You can also use any other docker image available on [Docker Hub][hub-pg].
 For example, to use PostgreSQL 9.3 the service becomes `postgres:9.3`.