# \#dev-install **URL:** https://meta.discourse.org/tag/dev-install/150.md [Latest](https://meta.discourse.org/latest.md) · [Categories](https://meta.discourse.org/categories.md) · [Tags](https://meta.discourse.org/tags.md) --- ## [Set up Discourse for development on Fedora Linux](https://meta.discourse.org/t/set-up-discourse-for-development-on-fedora-linux/163348)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 13\ **Last updated:** [June 19, 2026, 5:20am UTC](https://meta.discourse.org/t/set-up-discourse-for-development-on-fedora-linux/163348 "2026-06-19T05:20:22Z")
This guide has been tested against a fresh install of Fedora 31 and 33, but may work on older versions that also use dnf as the package management tool. This is not an official guide but may be useful for other developer… --- ## [Install Discourse on Windows for development](https://meta.discourse.org/t/install-discourse-on-windows-for-development/75149)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 16\ **Last updated:** [April 22, 2026, 10:18am UTC](https://meta.discourse.org/t/install-discourse-on-windows-for-development/75149 "2026-04-22T10:18:42Z")
:information\_source: This tutorial has been tested on Windows 10 and 11. To set up a development environment for Discourse on Windows, you can do it using Windows Subsystem for Linux feature. This setup requires the … --- ## [Install Discourse on Ubuntu or Debian for Development](https://meta.discourse.org/t/install-discourse-on-ubuntu-or-debian-for-development/14727)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 83\ **Last updated:** [June 22, 2025, 12:31am UTC](https://meta.discourse.org/t/install-discourse-on-ubuntu-or-debian-for-development/14727 "2025-06-22T00:31:14Z")
:warning: This guide covers installation instructions in a development environment. For a production guide see: Install Discourse in production with the official supported instructions So you want to set up Discour… --- ## [Install Discourse on macOS for development](https://meta.discourse.org/t/install-discourse-on-macos-for-development/15772)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 102\ **Last updated:** [April 24, 2026, 6:38pm UTC](https://meta.discourse.org/t/install-discourse-on-macos-for-development/15772 "2026-04-24T18:38:20Z")
:warning: This guide covers installation instructions for a macOS development environment, for production guides see: Install Discourse in production with the official supported instructions So you want to set up Disc… --- ## [Discourse-events can cause 500 when deleting a topic in development: uninitialized Calendar::Extractor](https://meta.discourse.org/t/discourse-events-can-cause-500-when-deleting-a-topic-in-development-uninitialized-calendar-extractor/411731)
**Author:** [@Ethsim2](https://meta.discourse.org/u/Ethsim2)\ **Replies:** 1\ **Last updated:** [September 8, 2026, 4:24am UTC](https://meta.discourse.org/t/discourse-events-can-cause-500-when-deleting-a-topic-in-development-uninitialized-calendar-extractor/411731 "2026-09-08T04:24:37Z")
While testing some unrelated topic-deletion changes in a local development instance, deleting a topic returned a 500 Internal Server Error. The development instance which produced the error was running this exact Discou… --- ## [When will support for deploying the Discourse development environment using WSL containers be available?](https://meta.discourse.org/t/wsl-discourse/406743)
**Author:** [@AkarinLiu](https://meta.discourse.org/u/AkarinLiu)\ **Replies:** 2\ **Last updated:** [July 4, 2026, 10:22am UTC](https://meta.discourse.org/t/wsl-discourse/406743 "2026-07-04T10:22:11Z")
Microsoft recently introduced WSL containers. My computer has Docker Desktop and WSL installed, but developing Discourse plugins or themes on Windows currently requires Docker. With this new feature, we could potentially avoid depending on Docker. I wonder when support for installing Discourse using WSL containers will be available? --- ## [Set up a multisite development environment](https://meta.discourse.org/t/set-up-a-multisite-development-environment/229310)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [June 7, 2022, 4:01pm UTC](https://meta.discourse.org/t/set-up-a-multisite-development-environment/229310 "2022-06-07T16:01:37Z")
It’s possible to run discourse in multisite mode in development. A multisite server uses a different DB and hostname for each site that it serves. This is useful if you are developing a feature or a plugin that should be… --- ## [Install plugins in your non-Docker development environment](https://meta.discourse.org/t/install-plugins-in-your-non-docker-development-environment/205337)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [October 6, 2021, 9:47am UTC](https://meta.discourse.org/t/install-plugins-in-your-non-docker-development-environment/205337 "2021-10-06T09:47:24Z")
(This guide only covers non-docker dev install. For Docker dev :whale: see Install Discourse for development using Docker) If you’ve followed the instructions to set up your local discourse, you can install a plugin loc… --- ## [Install Discourse for development using Docker](https://meta.discourse.org/t/install-discourse-for-development-using-docker/102009)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 226\ **Last updated:** [May 22, 2026, 5:35am UTC](https://meta.discourse.org/t/install-discourse-for-development-using-docker/102009 "2026-05-22T05:35:27Z")
Developing using Docker Since Discourse runs in Docker, you should be able to run Discourse directly from your source directory using a Discourse development container. :white\_check\_mark: Pros: No need to install any … --- ## [Set up a local Discourse Development Environment?](https://meta.discourse.org/t/set-up-a-local-discourse-development-environment/182882)
**Author:** [@Discourse](https://meta.discourse.org/u/Discourse)\ **Replies:** 0\ **Last updated:** [March 11, 2021, 11:33am UTC](https://meta.discourse.org/t/set-up-a-local-discourse-development-environment/182882 "2021-03-11T11:33:53Z")
So you want to set up Discourse locally to hack on and develop with? This root guide links all the dev-install guides for the various systems to setup Discourse locally on. If you want to add a guide to this list, be su… --- ## [Guide to Setting Up Discourse Development Environment - Windows 11](https://meta.discourse.org/t/guide-to-setting-up-discourse-development-environment-windows-11/282227)
**Author:** [@AliBenBongo](https://meta.discourse.org/u/AliBenBongo)\ **Replies:** 18\ **Last updated:** [March 8, 2026, 1:48pm UTC](https://meta.discourse.org/t/guide-to-setting-up-discourse-development-environment-windows-11/282227 "2026-03-08T13:48:16Z")
Hi Everyone, After spending some time attempting to get a working development environment up and running under Windows 11 / WSL2 I thought I would share the steps that I have followed. This is my first post here so I h… --- ## [Install a Discourse development environment on Windows](https://meta.discourse.org/t/installer-un-environnement-developpement-discourse-sur-windows/397803)
**Author:** [@gilles](https://meta.discourse.org/u/gilles)\ **Replies:** 4\ **Last updated:** [March 6, 2026, 11:55am UTC](https://meta.discourse.org/t/installer-un-environnement-developpement-discourse-sur-windows/397803 "2026-03-06T11:55:37Z")
Hello, I want to try getting started with developing plugins for Discourse. I wanted to know if the documentation for Windows is still valid since it dates from 2017 :sweat\_smile: Otherwise, do you have any other solut... --- ## [Installing discourse follow plugin in development (boot\_dev) setup — no app.yml file](https://meta.discourse.org/t/installing-discourse-follow-plugin-in-development-boot-dev-setup-no-app-yml-file/396398)
**Author:** [@nitinkg](https://meta.discourse.org/u/nitinkg)\ **Replies:** 2\ **Last updated:** [February 26, 2026, 10:00am UTC](https://meta.discourse.org/t/installing-discourse-follow-plugin-in-development-boot-dev-setup-no-app-yml-file/396398 "2026-02-26T10:00:58Z")
Hi, I’m running Discourse locally in development mode using docker. I’m trying to install the discourse follow plugin: Plugin: https://meta.discourse.org/t/discourse-follow/110579 I followed the plugin installation … --- ## [/admin/config/emoji non responsive/locks up](https://meta.discourse.org/t/admin-config-emoji-non-responsive-locks-up/394857)
**Author:** [@oxo](https://meta.discourse.org/u/oxo)\ **Replies:** 2\ **Last updated:** [February 2, 2026, 11:53pm UTC](https://meta.discourse.org/t/admin-config-emoji-non-responsive-locks-up/394857 "2026-02-02T23:53:58Z")
when using a fresh development environment following the steps here: when you go to /admin/config/emoji clicking on “Settings” “Add emoji” does not load the pages, this requires a page refresh after clicking the links… --- ## [Avatar upload issue (Ubuntu)](https://meta.discourse.org/t/avatar-upload-issue-ubuntu/394901)
**Author:** [@tom1984](https://meta.discourse.org/u/tom1984)\ **Replies:** 9\ **Last updated:** [February 2, 2026, 10:01pm UTC](https://meta.discourse.org/t/avatar-upload-issue-ubuntu/394901 "2026-02-02T22:01:18Z")
This was split from the win 11 wsl dev environment setup thread. My issues relate to a dev setup (non-docker) installed on ubuntu 22.04.3 …Thanks for this, I had to do some extra manual steps though as the edited insta… --- ## [Created a user from command line. Supposedly active, but isn't?](https://meta.discourse.org/t/created-a-user-from-command-line-supposedly-active-but-isnt/394837)
**Author:** [@Canapin](https://meta.discourse.org/u/Canapin)\ **Replies:** 1\ **Last updated:** [January 31, 2026, 11:33am UTC](https://meta.discourse.org/t/created-a-user-from-command-line-supposedly-active-but-isnt/394837 "2026-01-31T11:33:35Z")
bundle exec rake admin:create Email: canapin3@gmail.com Password: Repeat password: Ensuring account is active! Account created successfully with username user3 Do you want to grant Admin privileges to this account… --- ## [Backup restore failing on clean dev docker env: FATAL: Peer authentication failed for user “postgres”](https://meta.discourse.org/t/backup-restore-failing-on-clean-dev-docker-env-fatal-peer-authentication-failed-for-user-postgres/208170)
**Author:** [@koen360](https://meta.discourse.org/u/koen360)\ **Replies:** 14\ **Last updated:** [January 6, 2026, 11:26am UTC](https://meta.discourse.org/t/backup-restore-failing-on-clean-dev-docker-env-fatal-peer-authentication-failed-for-user-postgres/208170 "2026-01-06T11:26:27Z")
Hi over in the beginners guide to install discourse for development using docker some of the comments mention this issue which I think is actually a bug that should be raised as such here. Correct me if I am wrong. I te… --- ## [How can I install Discourse on Windows? Getting restarting (100) error](https://meta.discourse.org/t/how-can-i-install-discourse-on-windows-getting-restarting-100-error/383610)
**Author:** [@Turgut\_Ordu](https://meta.discourse.org/u/Turgut_Ordu)\ **Replies:** 3\ **Last updated:** [September 30, 2025, 2:37pm UTC](https://meta.discourse.org/t/how-can-i-install-discourse-on-windows-getting-restarting-100-error/383610 "2025-09-30T14:37:53Z")
Hi everyone, I have been trying to install Discourse on both Windows and Mac for several hours but I always end up with the same issue. After running the setup and starting the container, when I check with docker ps, … --- ## [Plugin devcontainer config for GitHub Codespaces](https://meta.discourse.org/t/plugin-devcontainer-config-for-github-codespaces/380851)
**Author:** [@Alteras](https://meta.discourse.org/u/Alteras)\ **Replies:** 0\ **Last updated:** [August 29, 2025, 3:00am UTC](https://meta.discourse.org/t/plugin-devcontainer-config-for-github-codespaces/380851 "2025-08-29T03:00:40Z")
I recently made a GitHub Codespaces devcontainer config for discourse plugins that will automatically clone the discourse core repo around the plugin, generating a fresh discourse dev environment for each plugin. ▶ Scree… --- ## [Can Discourse run on CodeSandbox?](https://meta.discourse.org/t/can-discourse-run-on-codesandbox/380456)
**Author:** [@NateDhaliwal](https://meta.discourse.org/u/NateDhaliwal)\ **Replies:** 0\ **Last updated:** [August 27, 2025, 12:43am UTC](https://meta.discourse.org/t/can-discourse-run-on-codesandbox/380456 "2025-08-27T00:43:40Z")
I wonder, is it possible to run Discourse (as a dev environment) in CodeSandbox? IIRC it has sudo access and a 4 vCPU, 8 GB RAM tier for sandboxes. --- ## [Nice way to run a dev env](https://meta.discourse.org/t/nice-way-to-run-a-dev-env/375233)
**Author:** [@NateDhaliwal](https://meta.discourse.org/u/NateDhaliwal)\ **Replies:** 2\ **Last updated:** [July 22, 2025, 10:49pm UTC](https://meta.discourse.org/t/nice-way-to-run-a-dev-env/375233 "2025-07-22T22:49:45Z")
Hi everyone, just sharing a handy script I’ve put together that helps me run my Discourse dev instance. It pulls all the latest changes, pulls the updates from installed plugins, and runs all the migrations, as well as … --- ## [Switch tracking branch in dev install?](https://meta.discourse.org/t/switch-tracking-branch-in-dev-install/372785)
**Author:** [@NateDhaliwal](https://meta.discourse.org/u/NateDhaliwal)\ **Replies:** 3\ **Last updated:** [July 3, 2025, 11:24pm UTC](https://meta.discourse.org/t/switch-tracking-branch-in-dev-install/372785 "2025-07-03T23:24:13Z")
Is it possible to switch my branch on my dev install from tests-passed to stable? I couldn’t get git fetch origin git checkout stable git pull to work. --- ## [About the SMTP config](https://meta.discourse.org/t/about-the-smtp-config/365569)
**Author:** [@zhongziqi](https://meta.discourse.org/u/zhongziqi)\ **Replies:** 2\ **Last updated:** [May 22, 2025, 12:18am UTC](https://meta.discourse.org/t/about-the-smtp-config/365569 "2025-05-22T00:18:13Z")
I used Windows 10’s WSL2 to install Docker and deployed my own Discourse application.I modified the SMTP configuration items in discourse/config/discourse\_defaults.conf, and re-ran d/boot\_dev -p, d/rails s, and d/ember-c… --- ## [Development setup hangs when updating client.en.yml](https://meta.discourse.org/t/development-setup-hangs-when-updating-client-en-yml/366555)
**Author:** [@elmuerte](https://meta.discourse.org/u/elmuerte)\ **Replies:** 1\ **Last updated:** [May 18, 2025, 3:11pm UTC](https://meta.discourse.org/t/development-setup-hangs-when-updating-client-en-yml/366555 "2025-05-18T15:11:09Z")
I have a discourse development setup running within WSL. This works quite ok for working on plugins. But today I noticed something weird, whenever I edit the config/locales/client.en.yml file the systems hangs. I cannot… --- ## [Plugin No Longer Loading or Visible](https://meta.discourse.org/t/plugin-no-longer-loading-or-visible/357679)
**Author:** [@bitmage](https://meta.discourse.org/u/bitmage)\ **Replies:** 1\ **Last updated:** [March 18, 2025, 1:35am UTC](https://meta.discourse.org/t/plugin-no-longer-loading-or-visible/357679 "2025-03-18T01:35:34Z")
My plugin, although in the plugins directory of my Discourse instance, is no longer loaded or displaying in the Admin interface. I’m using Docker in my Discourse development environment. I previously had problems with … --- ## [Dev Container memory usage really high?](https://meta.discourse.org/t/dev-container-memory-usage-really-high/355701)
**Author:** [@dsims](https://meta.discourse.org/u/dsims)\ **Replies:** 4\ **Last updated:** [March 5, 2025, 3:56am UTC](https://meta.discourse.org/t/dev-container-memory-usage-really-high/355701 "2025-03-05T03:56:59Z")
I’m on a M2 Macbook Pro using the Dev Container setup. Memory usage seems really high, is this typical? I see about 4GB memory usage before running anything, then needing about 10GB to get through a successful build and … --- ## [Chat not working after dev install](https://meta.discourse.org/t/chat-not-working-after-dev-install/354575)
**Author:** [@Neeraj\_Keriya](https://meta.discourse.org/u/Neeraj_Keriya)\ **Replies:** 21\ **Last updated:** [February 27, 2025, 10:52am UTC](https://meta.discourse.org/t/chat-not-working-after-dev-install/354575 "2025-02-27T10:52:09Z")
After following all steps in doc: Install Discourse on Ubuntu or Debian for Development I tried running server using “bin/ember-cli -u” and (“bin/ember-cli” + “rails s” in saparate terminal windows). I am getting error… --- ## [Emails Not Sending to New or Existing Users Despite Logs Showing No Issues](https://meta.discourse.org/t/emails-not-sending-to-new-or-existing-users-despite-logs-showing-no-issues/343105)
**Author:** [@Sidi\_Codet](https://meta.discourse.org/u/Sidi_Codet)\ **Replies:** 5\ **Last updated:** [December 18, 2024, 9:38pm UTC](https://meta.discourse.org/t/emails-not-sending-to-new-or-existing-users-despite-logs-showing-no-issues/343105 "2024-12-18T21:38:39Z")
Hi everyone, I’ve been running my Discourse community for almost three months at Forum, and everything has been working fine until recently. Now, emails are not being sent to either new or existing users. I’ve checked … --- ## [(outdated) Guide to Setting Up Discourse Development Environment - GitHub Codespace](https://meta.discourse.org/t/outdated-guide-to-setting-up-discourse-development-environment-github-codespace/307231)
**Author:** [@jordan-violet](https://meta.discourse.org/u/jordan-violet)\ **Replies:** 8\ **Last updated:** [November 14, 2024, 12:20pm UTC](https://meta.discourse.org/t/outdated-guide-to-setting-up-discourse-development-environment-github-codespace/307231 "2024-11-14T12:20:09Z")
Developing Using GitHub Codespaces GitHub Codespace is a great development option. It’s great because it’s hosted in the cloud, I can easily ensure that everyone developing here has the same environment, no dealing wit… --- ## [Development install fails when running bin/rails db:migrate](https://meta.discourse.org/t/development-install-fails-when-running-bin-rails-db-migrate/332754)
**Author:** [@NateDhaliwal](https://meta.discourse.org/u/NateDhaliwal)\ **Replies:** 12\ **Last updated:** [November 8, 2024, 1:43am UTC](https://meta.discourse.org/t/development-install-fails-when-running-bin-rails-db-migrate/332754 "2024-11-08T01:43:15Z")
Basically, I am trying to do a dev install on my Pi, following this guide. I ran bin/rails db:create, which worked fine. Then when trying to run bin/rails db:migrate, it ends by saying something about oxipng binary file … [Next page](https://meta.discourse.org/tag/dev-install/150.md?match_all_tags=true&page=1&tags%5B%5D=dev-install)