Using a launcher built docker image in docker-compose

But is it simple if said image ends up not being representative, lags behind official releases and said developers and sysadmins are unable to get support here?

It’s always frustrating for users when tell them their install is completely unsupported, you’re effectively asking for guidance in building another unsupportable install. Do the IndieHosters understand that you/they will be totally on their own with this?

1 Like

I totally agree. That’s why I suggested to our dev lead not to use the bitnami/discourse images, why he asked me to research the best way forward and why I’ve chosen to use the image(s) created by ./launcher as suggested by

So the question for me now is, how to generate the base image(s) using launcher and bring up the environment using compose?

I’ve already tried using the image created by ./launcher rebuild app.
I’m about to look at ./launcher bootstrap app.

… bootstrap is called by rebuild so there would be no difference in the resultant image …

The image from bootstrap is fine, in fact it is running here on meta, PG is running on AWS RDS, Redis in a dedicated container.


I know the image is fine Sam. We’re using it on a staging server. I clearly understand that what is lacking here currently is my knowledge on how to run the scripts required to setup the shared folders within docker-compose.

I am super confused at why you would even want to involve compose.

This gives your devs an ultra easy setup path on local:

In production … why would you even think about deploying with compose? In general production container orchestration happens in either scripts or kubernates or some other dedicated production tool.

It’s only for testing instances

Mainly because I’ve been asked to by our team lead. His argument is when testing … he doesn’t want to rely on sysadmins, or devs knowing how to set up discourse other than doing docker-compose up -d.

1 Like

I agree … I followed the instructions and it didn’t take a lot of time to set up. The main issue I will have is selling the idea of running the scripts

I am still not following at all, maybe ask your dev manager to post here explaining why our officially supported docker dev setup is a problem.


I asked if Beginners Guide to Install Discourse for Development using Docker would suffice.

The answer was yes.


I am not associated with the OP here, but I can tell you why I want a docker compose file rather than a shell script:

  1. Shell scripts tend to not work on Windows.
  2. The shell script requires git, my docker hosts only have a bare OS and docker installed. They are, by design, incredibly lean and bare.
  3. Docker compose files can, with a little work, be converted to docker swarm files which can be run on my infrastructure and managed with docker swarm management tooling.
  4. Every other piece of my infrastructure is managed via docker-swarm tooling. Having a single piece of infrastructure that is an outlier adds a large amount of cognitive overhead that I need to store somewhere and will certainly be lost/forgotten when it comes time to upgrade (every other piece of our infrastructure gets upgrades by just updating image version in docker swarm file).

What I would like to see is a template docker swarm or docker compose file that I can use, which references an image published to Docker Hub, and I can configure by just editing the various swarm file settings.

I haven’t yet tried running the scripts locally to see if I can extract the compose file, but it sounds like that is my best bet to not have Discourse be some oddball outlier in my system. I would prefer if I didn’t need to go run a script just to generate a sample docker-compose/swarm file and if instead I could just see one in docs or a gist or something.


I want to be able to do all docker building on a separate build server to where I run in production. Why use Docker if it is a bunch of scripts that are required on the host?

On my production host I want Docker installed in swarm mode and the ability to Docker login to my registry to pull what is needed. I also want to be able to run e.g 3 instances of any container over 3 nodes (so any volumes / bind mounts to the host should be easily manageable).

Totally happy to build and do exactly the supported discourse way on staging server.

The prod docker swarm I am talking about will include many other products on the same cluster.

I plan to docker inspect all the containers on my Discourse officially supported staging server, push all pre-built docker images to a registry and try deploy them to production swarm cluster.

If I get there I will share here.

I would want to split out into multiple containers. From what I have seen, the officially supported Discourse treats Docker like VM and does everything in one container (how do you scale only one component if necessary?).

Maybe the open-sourced supported version is purposefully not orchestration manager friendly so that they can get contracts to manage deploys that require massive scale. That model sits fine by me. They should have every right to be able to make money installing Discourse to large already established production grade Swarm/Kubernetes systems.

Not saying that is how some of their income is earned, just speculating. Not important whether they are or not, just pointing out that they are in no way obligated to support anything other than their currently supported mechanisms. It must just be acknowledged that the supported method is not friendly towards a production grade container orchestration cluster.


My understanding is it for ease of support - that CDKC uses the open sourced version - they do make their income from hosting and that pays for the free support they give to the official supported version.

There is a guide to splitting the containers here Multisite configuration with Docker

We did manage to get a instance running under docker-compose so what you’re aiming for is certainly doable.

1 Like

Did you open-source it? Would be great to see some examples.

We used an older version of / compose / discourse · GitLab as a guide. That should get you going.


It’s May 2020 and this is still a completely contentious area of usage.

I’ve read every thread I can find on current Discourse support for docker and I’ve gone through the 5 stages of grief on this - I’m now at resignation.

Context -

I have a docker swarm that runs everything for our sites and businesses. I don’t want to buy/maintain additional VPS just to host a forum.

I just want to deploy Discourse image on it with individual containers so I can scale things differently as needed. So far I have failed. It should not be this hard.

I have done this with far more complex but comparable codebases like Gitlab and Sentry in 1-2 hours flat. This is my 3rd week of trying to get a working solution with Discourse and still no reliable installation.

Seems to me…

  • Discourse is feature rich and been around a while and has passionate and skilled contributors.
  • Discourse was an early adopter of containerisation and did what it did using both the tools and the knowledge around at the time.
  • Criticism of how it does what it does is often met with defensiveness.
  • Clear cut guidance is missing on this exact problem that many people over the last few years have asked and many more will ask in the future re: cluster orchestration.
  • Launcher etc is fine for a single docker machine, it is a beautiful script that suits a common use case. But my experience of using it create a portable image is failure.

Things that are silly…

  • the passive aggressive responses to legitimate concerns raised by people just trying to get a tiny part of their work done.
  • insisting that launcher is the ONLY way it should work.
  • referring to ‘documentation’ in threads that are out of date and expecting people to spend ages trying to read up such content to simply install something.

We can do better than this.

The ask / offer
I am willing to spend my time with someone who knows how launcher works and to create a step by step quide for creating repeatable separate container installs - with a video.

Who is up for this?


Hey Mike. Basically, what you do is use ./launcher bootstrap to build the image, push it to a repo, and then use ./launcher start-cmd to see what ENV needs to get passed to Docker to crank things up.

The reason that such a guide doesn’t exist is that people who don’t have the most basic understanding of any of the underlying pieces work will find it and not be able to make sense of it and then expect a tutorial on how ingress works on whatever system that the think is the only answer.


Call me crazy, but maybe you are living proof that we did things the way we did for a reason? :wink:

1 Like

Thanks Jay - I figured that much out. I finally made it work.

  • Will create a video and guide for exactly what I did, so that the next me doesn’t spend their time trying to figure this out.

I guess part of the issue is that it goes counter the grain of all the other docker images out there. It isn’t as plug and play. It is more fiddle, plug and then play.

As I said, the launcher is a beautiful and reliable thing for what it does.

On a really positive note, the web only build works a treat, its super fast on my swarm, updateable because I have the build server.

When I have time I will explore a build server on my swarm that allows a web based build of a docker image.

Things I tried that left much to be desired…

  • bitnami docker image - ran like a dog with no legs.
  • indiehosts dockerfile - didn’t get as far as a build - seemed determined to make everything, I think it was compiling linux. Again there has to an easier way!

Ok - thanks.