From 1411e5a0ff14ed79779611928b1515cd7470d6a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9gis=20Behmo?= <regis@behmo.com>
Date: Mon, 6 Sep 2021 14:35:29 +0200
Subject: [PATCH] docs: using docker-compose.override.yml

This feature was previously undocumented.

See: https://discuss.overhang.io/t/override-and-docker-compose/1857
---
 docs/local.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/local.rst b/docs/local.rst
index 5e305f4..8f93962 100644
--- a/docs/local.rst
+++ b/docs/local.rst
@@ -271,3 +271,12 @@ To dump all data from the MySQL and Mongodb databases used on the platform, run
     tutor local exec mongodb mongodump --out=/data/db/dump.mongodb
 
 The ``dump.sql`` and ``dump.mongodb`` files will be located in ``$(tutor config printroot)/data/mysql`` and ``$(tutor config printroot)/data/mongodb``.
+
+Customizing the deployed services
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You might want to customize the docker-compose services listed in ``$(tutor config printroot)/env/local/docker-compose.yml``. To do so, you should create a ``docker-compose.override.yml`` file in that same folder::
+
+    vim $(tutor config printroot)/env/local/docker-compose.override.yml
+
+The values in this file will override the values from ``docker-compose.yml`` and ``docker-compose.prod.yml``, as explained in the `docker-compose documentation <https://docs.docker.com/compose/extends/#adding-and-overriding-configuration>`__.