From 550202bf0a0a0962fe55f8a0022e10503323927f Mon Sep 17 00:00:00 2001
From: Ben Sturmfels <ben@sturm.com.au>
Date: Sun, 15 Aug 2021 23:10:29 +1000
Subject: Document running multiple MediaGoblin instances on one server.

---
 docs/source/siteadmin/production-deployments.rst | 25 ++++++++++++++++++++----
 docs/source/siteadmin/relnotes.rst               |  1 +
 2 files changed, 22 insertions(+), 4 deletions(-)

(limited to 'docs')

diff --git a/docs/source/siteadmin/production-deployments.rst b/docs/source/siteadmin/production-deployments.rst
index 2a78f479..52563e6e 100644
--- a/docs/source/siteadmin/production-deployments.rst
+++ b/docs/source/siteadmin/production-deployments.rst
@@ -107,7 +107,24 @@ documentation.
 .. _`raven`: http://raven.readthedocs.org
 
 
-.. TODO insert init script here
-.. TODO are additional concerns ?
-   .. Other Concerns
-   .. --------------
+Running multiple MediaGoblin instances on the same server
+---------------------------------------------------------
+
+It is possible to run multiple separate MediaGoblin instances concurrently on
+the same server. We don't provide detailed instructions to do this, but broadly,
+each instance will need:
+
+1. A separate ``mediagoblin.ini`` and ``paste.ini``.
+2. A separate database that is configured in ``mediagoblin.ini``.
+3. A unique ``CELERY_DEFAULT_QUEUE`` configured in ``mediagoblin.ini``. Queues
+   are automatically created, but must be unique between MediaGoblin instances.
+4. A separate data directory created and configured in ``mediagoblin.ini`` and
+   ``paste.ini``.
+5. A unique server port configured in ``paste.ini`` under ``[server:broadcast]``.
+
+You would typically configure the web server to route requests to the
+appropriate MediaGoblin instance port based on the requested domain name or
+something similar.
+
+It is also possible to share the same MediaGoblin codebase and Python virtualenv
+between multiple instances, so long as they have a unique data directory.
diff --git a/docs/source/siteadmin/relnotes.rst b/docs/source/siteadmin/relnotes.rst
index 390143a3..ee4b452f 100644
--- a/docs/source/siteadmin/relnotes.rst
+++ b/docs/source/siteadmin/relnotes.rst
@@ -39,6 +39,7 @@ This chapter has important information about our current and previous releases.
 - Remove references to previous `tinymce` JS dependency (Ben Sturmfels)
 - Remove plugin for decommissioned Mozilla Persona (Jgart)
 - Remove Debian 10 development Dockerfile (BenSturmfels)
+- Document running multiple MediaGoblin instances on one server (Ben Sturmfels)
 
 **Bug fixes:**
 
-- 
cgit v1.2.3