Multisite configuration with Docker

You may wish to host multiple domains on a singled Docker setup. To do so follow these instructions:

We strongly recommend you run separate web and data containers

The standalone container is extremely easy to configure, however has a couple of drawbacks

  1. You will need to stop your site when bootstrapping a new image
  2. You run through the db bootstrap only when needed

Multisite is a fairly advanced topic, learn about hooks before attempting this.

Understand hooks

Discourse templates use pups, its rules are simple and powerful.

Each rule you run may define a hook:

    cd: some/path
    hook: my_hook
      - echo 1

Later on in your container you can insert rules before or after a hook:

    - exec: echo "I ran before"
     - exec: echo "I ran after"

So in the example above you will see output like the following:

I ran before
I ran after

You can read through the templates in /var/discourse/templates to see what hooks you have available.

Amend your standalone container to provision the site and talk to it

Replace the entire hooks section with:

     - exec: sudo -u postgres createdb b_discourse || exit 0
     - exec:
          stdin: |
            grant all privileges on database b_discourse to discourse;
          cmd: sudo -u postgres psql b_discourse
          raise_on_fail: false

     - exec: /bin/bash -c 'sudo -u postgres psql b_discourse <<< "alter schema public owner to discourse;"'
     - exec: /bin/bash -c 'sudo -u postgres psql b_discourse <<< "create extension if not exists hstore;"'
     - exec: /bin/bash -c 'sudo -u postgres psql b_discourse <<< "create extension if not exists pg_trgm;"'

    - exec:
        cd: $home/plugins
          - mkdir -p plugins
          - git clone
    - file:
        path: $home/config/multisite.yml
        contents: |
           adapter: postgresql
           database: b_discourse
           pool: 25
           timeout: 5000
           db_id: 2

    - exec: cd /var/www/discourse && sudo -E -u discourse bundle exec rake multisite:migrate

There are 3 hooks in play:

  1. after_postgres, ensures that after postgres is installed an additional db called b_discourse is created with the appropriate permissions.

  2. before_bundle_exec, ensures docker_manager is in place and that the multisite.yml file is in place (which defines where to find the databases)

  3. after_bundle_exec, runs the custom db migration task rake multisite:migrate this ensures all the dbs are up to date.

The above sample can be split into data container / app container if needed (just run the after_postgres hook in the data container and the rest in web container)

The above sample can be extended to provision even more DBs, to do so, provision more dbs by duplicating the create db etc calls, and make sure you have additional sites in multisite.yml

Make sure you amend the host_names node in multisite.yml to match the actual host name you wish to host.

How to create 1000 subcategories in a scalable way?
How does multisite.yml look?
Multiple Forums in a Single Installation
Pros and cons of multiple standalone containers vs one for multiple Discourse installs?
Multiple Discourses, multiple containers, one server
Multisite Installation
Will I need to start over with multisite configuration from standalone version?
Success - New Multisite Install on Dedicated server using ServerPilot, Nginx and Apache
Installation wizard not appearing in multisite installs
Sandbox and test discourse on host?
Multiple Discourse Installs - Single Server
Starting a second Discourse forum on the same VPS
Disabling/restricting user search
Pros and cons of a multisite installation
Discourse multisite installation help with digitalocean
Need proper documentation for multisite discourse with docker
How do you set up multiple discourse forums on the same server?
Multi-site Installation
How to move from standalone container to separate web and data containers
Second discourse instance on the same server
Multisite installation with seperated smtp emails
Can I log into multiple instances of discourse simultaneously?
Multisite viability - 2 read-only and 1 active
Multiple discourse instances in a single server
Install Discourse on Plesk / Ubuntu 14 without Docker
Totally Walled-Off Groups
Discourse for 3 different Countrys
Three sites in one setup
I want to host hundreds of instances of Discourse
Multiple discourse instances in a single server
Help me setup many websites on one VPS
How to move from standalone container to separate web and data containers
Using a launcher built docker image in docker-compose
How do I set category tracking level defaults historically
How to move from standalone container to separate web and data containers
Can we change lets encrypt script?
Contabo experience with Plesk, Webmin or other server-admin setup?
Multiple container setup problems
App.yml shared volumes for a two website setup
Installing on Kubernetes
Integration with .NET MVC application for a SaaS platform
Stable branch assets won't compile
Multisite for small collection of sites for a family?
Add path to cookie
Multitenat Dockerize Discourse
Need help with multisite configuration
PAID Require Discourse expert for extreme customization
Hosting Plan Suggestion for 500 Concurrent Online Users
Feature proposal: Customizations based on primary group membership, a.k.a. tenancy 'lite'
Avatar, Site Logos, and Cert Errors
Secure cookie configuration
Pull request for Wikis?
Stable branch assets won't compile
How can Admin login while Read-only mode is enabled on multisite?
How to move from standalone container to separate web and data containers
Can I have two domains pointing towards the same IP address without redirect?
How to move from standalone container to separate web and data containers
Multisite Config
Are there other workarounds to not having category moderation such as multiple instances of the board?
ActiveRecord::StatementInvalid: PG::UndefinedColumn: ERROR: column categories.search_priority does not exist
Multisite installation ... in subdirectories?
Best approach for test and production instance of discourse
Two standalone instances on one server?

@jomaxro can a tech advocate confirm the guide is accurate?


If you are having issues with this guide, open a separate support topic, this is closed pending verification