tutor/docs/tutorials/multiplatforms.rst

Running multiple Open edX platforms on a single server
======================================================

With Tutor, it is easy to run multiple Open edX instances on a single server. To do so, the following configuration parameters must be different for all platforms:

- ``TUTOR_ROOT``: so that configuration, environment and data are not mixed up between platforms.
- ``LOCAL_PROJECT_NAME``: the various docker-compose projects cannot share the same name.
- ``NGINX_HTTP_PORT``: ports cannot be shared by two different containers.
- ``LMS_HOST``, ``CMS_HOST``: the different platforms must be accessible from different domain (or subdomain) names.

In addition, a web proxy must be setup on the host, as described :ref:`in the corresponding tutorial <web_proxy>`.
docs: reorganize local guides in tutorials There is too much information in each of the local/k8s/dev docs pages. The "guides" that are listed in each one of those pages are moved either to "common tasks" or to a dedicated "tutorials" section. This paves the way for more comprehensive tutorials, where we describe how to run the latest master branches of Open edX. I am well aware that, as they stand, the tutorials are of poor quality and should be rewritten. This is a task for another day/commit. For now, we only move the contents to a separate part of the docs. Also, we should add a "reference" section to the docs, where we add the result of `tutor <subcommand> --help`. 2021-09-16 08:53:52 +00:00			`Running multiple Open edX platforms on a single server`
			`======================================================`

			`With Tutor, it is easy to run multiple Open edX instances on a single server. To do so, the following configuration parameters must be different for all platforms:`

			- ``TUTOR_ROOT``: so that configuration, environment and data are not mixed up between platforms.
			- ``LOCAL_PROJECT_NAME``: the various docker-compose projects cannot share the same name.
			- ``NGINX_HTTP_PORT``: ports cannot be shared by two different containers.
			- ``LMS_HOST``, ``CMS_HOST``: the different platforms must be accessible from different domain (or subdomain) names.

			In addition, a web proxy must be setup on the host, as described :ref:`in the corresponding tutorial <web_proxy>`.