Need proper documentation for multisite discourse with docker

Product Support Self-hosting

AI-generated summary

The discussion revolves around the need for proper documentation for setting up multisite Discourse with Docker. Pon_Athithan requests clear documentation for intermediate-level developers, to which codinghorror responds that existing documentation is available in the how-to category. Pon_Athithan struggles to find it, but eventually locates the relevant guide.

The conversation then shifts to the complexity of multisite setup, with codinghorror stating that it’s inherently complex and riking suggesting an alternative approach using multiple standalone containers. purldator inquires about the best approach, and neil shares a recent bug fix that may have affected multisite installations.

PabloC questions the added complexity introduced by Docker, suggesting that it’s more a matter of navigating the Docker ecosystem. sam responds that the process is relatively simple, involving provisioning the database and adding a multisite.yml file, which is documented in the how-to guide.

1

Hi,
I am searching a proper documentation to create multi site in single server but still I couldn’t find well defined documentation for intermediate level developer. I have tried some multisite discourse with docker articles but they haven’t helped me.

  1. http://www.webhostbug.com/setup-multisite-discourse/
  2. http://www.pixeldigit.com/technology/linux/discourse-multisite-install/

Please create a documentation something like this discourse/docs/INSTALL-cloud.md at main · discourse/discourse · GitHub . I believe it will be a very useful documentation for most of the developers. Thank you.

2

We already have it, search howto category here.

3

Do you mean this one ?

Sorry I am trying to create my first site if you guid me bit clearly it would be much appreciated.tnx

4

That’s the one, you found it!

Unfortunately, multisite is just complex. There really aren’t any shortcuts.

5

Well, the real shortcut is to just have multiple standalone containers. I don’t think we have a how-to on that.

6

Which is better? One multisite container containing all instances or multiple containers with their own instances? I’ve wondered about this.

7

@Pon_Athithan It’s likely that you were trying to launch a new multisite install when there was a bug that prevented that from working. I just ran into this today and fixed it.

This was the error:

StandardError: An error has occurred, this and all later migrations canceled:

undefined method `to_sym' for nil:NilClass/var/www/discourse/lib/slug.rb:6:in `for'

I think it’s been broken for the past 22 days, since this pr. If you can make it through our guide, it should work now.

8

Last year, before Docker, having a multisite installation was easy.

The only issues were:

1- Restart the App after updating to the latest version.
2- Running Migrations.
3- Some downtime during this process (nothing important for 99% of our Discourse installs)

What kind of complexity adds Docker to this?
I understand that having two or more containtesr seems better, is the correct way, but I don’t really see the compelxity of doing this properly, with a good documentation.

I think it’s complex because we need to understand better how to properly navigate the Docker ecosystem :smile: but not for Discourse.

Am I correct?

9

It’s just as “simple”

You provision the db and add multisite.yml

It’s documented in detail in the howto.

10

Thank you! I’ll will check it now.