Heyho! We created a repository called RPS Discourse Image Builder is used to create a Discourse OCI image. I think this might be helpful to some people looking here. We mainly did this so we don’t need to wait for the discourse deploy which takes long and to be able to version pin discourse reliably. We wrote a script that uses the discourse_docker repo to build the image with the stable version in the most general way possible. There is also a docker compose file that brings up the databases required for building and the discourse image for testing and runs it for local development. This can run on a GitLab runner with the shell executor, but you need a system with a docker-compose version that supports profiles. Approach The build script should be run within our CI/CD pipelines so we can easily update the version so further adjustments are done in different repos with Dockerfiles that are based on the image created by this repo. Background Discourse is a very nice piece of software, but it is not very easy to deploy and to version pin. This repository is used to create a docker image that can be used to deploy discourse. The problem is that discourse has a very unique way of building their docker images. The Discourse developers expect you to build the image on the target machine with their discourse_docker repo. There have been a lengthy discussions about this on the forum, TL;DR: The discourse lead developers refuse to support a public docker image that can be used to deploy discourse. They want to keep the discourse_docker repo as the only official way to deploy discourse. The main disadvatages for this approach are: It is not possible, from our experience, to version pin discourse reliably. It takes a long time to build the image and when the image is built the service is not available. Also discourse has the longest DevOps iteration cycle of all the services we support. Databases are managed in a different way than for usual docker based projects. The official Discourse deployment story is incompatible with OCI based development workflows and deployments, like Kubernetes or even Docker-Compose. The discourse_docker launcher makes a lot of assumptions about the environment it is running in. For example it refuses to run on rootless Podman with an error about missing storage volumes without being able to bypass this with an argument or env var.

[תמונה] Markus Katharina Brechtel: It is not possible, from our experience, to version pin discourse reliably. There is a version parameter on the app.yml file that can be set to the version you want to run. [תמונה] Markus Katharina Brechtel: It takes a long time to build the image and when the image is built the service is not available. Also discourse has the longest DevOps iteration cycle of all the services we support. Using the official install that is handled using Move from standalone container to separate web and data containers. [תמונה] Markus Katharina Brechtel: Databases are managed in a different way than for usual docker based projects. True, we try to make it friendly for webmasters from the “drag and drop this zip file contents with FileZilla via FTP”, while ensuring that everyone runs recent, supported and patched versions of all the software in the stack, even their Databases. For more knowledgeable Discourse admins, pointing to an externally managed database is an environment variable away per Configure Discourse to use a separate PostgreSQL server [תמונה] Markus Katharina Brechtel: The official Discourse deployment story is incompatible with OCI based development workflows and deployments, like Kubernetes or even Docker-Compose. Yes, the launcher based flow is not compatible out-of-the-box with container orchestration. That said, it can be made compatible by running ./launcher bootstrap app and pushing the resulting image to a container registry and then running said image via orchestration. [תמונה] Markus Katharina Brechtel: For example it refuses to run on rootless Podman with an error about missing storage volumes without being able to bypass this with an argument or env var. We welcome a pull request to make this possible, as it sounds useful generally. #pr-welcome

[תמונה] Falco: There is a version parameter on the app.yml file that can be set to the version you want to run. We tried that to create a deployment from 2.8, but it fails complaining about a wrong Discourse version. Since we can now reproduce this in our CI/CD you can look at the error here: docker-build (#4121616927) · Jobs · idcohorts / RPS / Discourse Image Builder · GitLab [תמונה] Falco: Using the official install that is handled using Move from standalone container to separate web and data containers. [תמונה] Falco: Yes, the launcher based flow is not compatible out-of-the-box with container orchestration. That said, it can be made compatible by running ./launcher bootstrap app and pushing the resulting image to a container registry and then running said image via orchestration. That’s what we are doing basically. :slight_smile: [תמונה] Falco: We welcome a pull request to make this possible, as it sounds useful generally. #pr-welcome Thank you, on it.

[תמונה] Markus Katharina Brechtel: We tried that to create a deployment from 2.8, but it fails complaining about a wrong Discourse version. Since we can now reproduce this in our CI/CD you can look at the error here: docker-build (#4121616927) · Jobs · idcohorts / RPS / Discourse Image Builder · GitLab That’s because Discourse 2.8 is unsupported now, which means we didn’t back port newest Ruby to it, and it runs on a Ruby version that’s already EOL. No one should run it in production.

[תמונה] Markus Katharina Brechtel: Thank you, on it. Done, see add bypasses for unsupported docker versions by mkbrechtel · Pull Request #706 · discourse/discourse_docker · GitHub

[תמונה] Falco: That’s because Discourse 2.8 is unsupported now, which means we didn’t back port newest Ruby to it, and it runs on a Ruby version that’s already EOL. No one should run it in production. Still it is not even technically possible (with just changing the version parameter), so we can’t reproduce old environments anymore.

[תמונה] Robert: well you can, you just have to use an older base image. How would i do that? I searched for it and did not find a solution…

You literally reference the older base image (created approximately around the date of the release you are targeting - it obviously must be at least later) There are pages (and pages!) of them: discourse/base - Docker Image

[תמונה] Falco: There is a version parameter on the app.yml file that can be set to the version you want to run. But if you try to pin to a version that is too old, it may not work with updated versions of the Discourse base image. I can’t remember specific examples, but stuff like and old version of Discourse won’t work with Ruby 3.2, so you (sometimes) also need to pin discourse_docker if you pin to an old version of Discourse. The safest and, in most cases, least wasteful solution is to build an image and push it to a repo rather than building a new image at every deployment. And if you have plugins, you’re likely to need to pin each of those as well. [תמונה] Falco: it can be made compatible by running ./launcher bootstrap app and pushing the resulting image to a container registry and then running said image via orchestration. I’ve done this for several clients for ECS as well as k8s on GCP and AWS. [תמונה] Markus Katharina Brechtel: so we can’t reproduce old environments anymore. I’m pretty sure that you can if you also pin discourse_docker to the old version. As I mentioned above, it’s more complicated with plugins, as you’re likely to need to pin those to the old versions as well. If you really want to maintain old versions building them exactly once and pushing them to a repo is the way to go. I’m doing this with a client to test upgrade paths from current production to latest and it’s working smoothly.

בונה תמונות Discourse עבור צינורות Gitlab CI/CD

תמיכה התקנה

mkbrechtel (Markus Katharina Brechtel) 17 באפריל,‏ 2023,‏ 6:14pm 8

Still it is not even technically possible (with just changing the version parameter), so we can’t reproduce old environments anymore.

נושא		תגובות	צפיות
Building Discourse image from discourse/discourse - how to install plugins Self-hosting docker , install , hosting	10	684	9 בפברואר,‏ 2026
Is Docker image discourse/discourse considered safe and production-ready? Self-hosting hosting	30	3721	26 במאי,‏ 2026
Community supported official docker image Development	35	9307	22 ביולי,‏ 2022
How to run a pulled discourse image on digitalocean docker? Product Support unsupported-install	3	1658	18 בנובמבר,‏ 2018
Using a launcher built docker image in docker-compose Development	30	8537	27 בספטמבר,‏ 2024

בונה תמונות Discourse עבור צינורות Gitlab CI/CD

נושאים קשורים