# Need proper documentation for multisite discourse with docker

**URL:** https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297
**Category:** Self-hosting
**Tags:** docker
**Created:** [May 4, 2015, 7:14pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297 "2015-05-04T19:14:42Z")
**Posts on this page:** 10
**Page:** 1

<div class="post-metadata">

### Author: ![Pon\_Athithan](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pon_athithan/32/43095_2.png) [@Pon\_Athithan](https://meta.discourse.org/u/Pon_Athithan)
#### Post date: [May 4, 2015, 7:14pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/1 "2015-05-04T19:14:42Z")

</div>

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/](http://www.webhostbug.com/setup-multisite-discourse/)
2. [http://www.pixeldigit.com/technology/linux/discourse-multisite-install/](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](https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md) . I believe it will be a very useful documentation for most of the developers. Thank you.

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [May 4, 2015, 8:45pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/2 "2015-05-04T20:45:22Z")

</div>

We already have it, search howto category here.

---

<div class="post-metadata">

### Author: ![Pon\_Athithan](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pon_athithan/32/43095_2.png) [@Pon\_Athithan](https://meta.discourse.org/u/Pon_Athithan)
#### Post date: [May 4, 2015, 9:13pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/3 "2015-05-04T21:13:04Z")

</div>

Do you mean this one ?

> [@Multisite configuration with Docker](https://meta.discourse.org/t/multisite-configuration-with-docker/14084):
>
> warning While multisite is supported in the Discourse application, this is an advanced sysadmin setup. If you don’t know what you’re doing, do not set up multisite. The Discourse team is unable to provide multisite configuration support. If you wish to host multiple domains on a singled Docker setup, you’ll need a multisite configuration. Here are the basic building blocks for one. Understand hooks Multisite is a fairly advanced topic. Before attempting a multisite build, spend some time…

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

---

<div class="post-metadata">

### Author: ![codinghorror](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/codinghorror/32/110067_2.png) [@codinghorror](https://meta.discourse.org/u/codinghorror)
#### Post date: [May 4, 2015, 9:26pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/4 "2015-05-04T21:26:27Z")

</div>

That’s the one, you found it!

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

---

<div class="post-metadata">

### Author: ![riking](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/riking/32/170938_2.png) [@riking](https://meta.discourse.org/u/riking)
#### Post date: [May 4, 2015, 9:54pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/5 "2015-05-04T21:54:14Z")

</div>

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

---

<div class="post-metadata">

### Author: ![purldator](https://avatars.discourse-cdn.com/v4/letter/p/bcef8e/32.png) [@purldator](https://meta.discourse.org/u/purldator)
#### Post date: [May 5, 2015, 9:58pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/6 "2015-05-05T21:58:22Z")

</div>

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

---

<div class="post-metadata">

### Author: ![neil](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/neil/32/102150_2.png) [@neil](https://meta.discourse.org/u/neil)
#### Post date: [May 5, 2015, 11:05pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/7 "2015-05-05T23:05:27Z")

</div>

@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:

```plaintext
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](https://github.com/discourse/discourse/pull/3370). If you can make it through our guide, it should work now.

---

<div class="post-metadata">

### Author: ![PabloC](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pabloc/32/49633_2.png) [@PabloC](https://meta.discourse.org/u/PabloC)
#### Post date: [May 19, 2015, 8:03pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/8 "2015-05-19T20:03:48Z")

</div>

> [@codinghorror](#):
>
> Unfortunately, multisite is just complex. There really aren’t any shortcuts.

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 😄 but not for Discourse.

Am I correct?

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [May 19, 2015, 9:48pm UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/9 "2015-05-19T21:48:02Z")

</div>

It’s just as “simple”

You provision the db and add multisite.yml

It’s documented in detail in the howto.

---

<div class="post-metadata">

### Author: ![PabloC](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pabloc/32/49633_2.png) [@PabloC](https://meta.discourse.org/u/PabloC)
#### Post date: [May 20, 2015, 7:39am UTC](https://meta.discourse.org/t/need-proper-documentation-for-multisite-discourse-with-docker/28297/10 "2015-05-20T07:39:45Z")

</div>

Thank you! I’ll will check it now.
