在macOS上安装Discourse以进行开发

Discourse · 2014 年5 月 19 日 16:59

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 Discourse on macOS to hack on and develop with?

We’ll assume that you don’t have Ruby/Rails/Postgres/Redis installed on your Mac. Let’s begin !

Install Discourse Dependencies

You will need the following packages on your system:

** optional

restart your terminal

Now that we have installed Discourse dependencies, let’s move on to install Discourse itself.

Restart your Terminal

Exit your shell and restarting it ensures that the paths to the installed packages are correctly picked up by the Terminal.

Clone Discourse

Clone the Discourse repository in ~/discourse folder:

git clone https://github.com/discourse/discourse.git ~/discourse

~ indicates home folder, so Discourse source code will be available in your home folder.

Bootstrap Discourse

Switch to your Discourse folder:

cd ~/discourse

Install the needed gems

bundle install

Install the JS dependencies

pnpm install

Next, run these commands to set up your local Discourse instance:

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

Start rails + Ember servers, you have two options here.

Option 1: using two separate Terminal tabs/windows, run Rails and Ember CLI separately via

bundle exec rails server

and

bin/ember-cli

Option 2: using only one Terminal tab/window:

bin/ember-cli -u # will run the Unicorn server in the background

You should now be able to navigate to http://localhost:4200 to see your local Discourse installation. (Note that the first load can take up to a minute as the server is warmed up.)

You can also try running the specs:

bundle exec rake autospec

All (or almost all) the tests should pass.

Create New Admin

To create a new admin, run the following command:

RAILS_ENV=development bundle exec rake admin:create

Follow the prompts to create an admin account.

Configure Mail

Run MailHog:

mailhog

Congratulations! You are now the admin of your own Discourse installation!

Happy hacking! And to get started with that, see Beginner’s Guide to Creating Discourse Plugins.

This document is version controlled - suggest changes on github.

jamesmarkcook · 2014 年7 月 27 日 21:00

If anyone is getting failing specs with most of them being .count errors, then try the following:

RAILS_ENV=test bundle exec rake db:reset

I had a problem where development data somehow got into my test database and was causing lots of failures.

henrikbg · 2016 年7 月 21 日 20:18

Is it possible to reset a discourse completely?

techAPJ · 2016 年7 月 22 日 01:55

Yes, do:

rake db:drop db:create db:migrate

Note that this will wipe everything and you will have to create your Admin user account again.

Chaboi_3000 · 2019 年4 月 30 日 06:33

Can someone assist me in how I can update my discourse?

/launcher rebuild app

returns an error.

techAPJ · 2019 年4 月 30 日 07:04

./launcher rebuild app is for discourse_docker based production setup. To update local/development Discourse instance you need:

cd ~/discourse
git pull origin master

Chaboi_3000 · 2019 年4 月 30 日 07:09

I get this error @techAPJ,

error: Your local changes to the following files would be overwritten by merge:
	.gitignore
Please commit your changes or stash them before you merge.
Aborting

techAPJ · 2019 年4 月 30 日 07:11

The error message is pretty clear:

Please commit your changes or stash them before you merge.

If you want to ignore your local changes, do:

git fetch origin
git reset --hard origin/master

Decorbuz · 2021 年11 月 5 日 22:35

Using the guide from the Ruby on Rails forum, I’m currently stuck on step 7.

This is probably a very “newbie” question, but how do I “point” to the experimental branch that was linked in that topic? I tried a few things and was ultimately giving the Unknown command mini_racer, message every single time.

blake · 2021 年11 月 5 日 23:28

They’re fine asking here.

There are some specific m1 instructions we wrote that we reference on the rails forum in this guide.

I’d have to look on my m1 air later, and maybe my fellow coworks who recently setup new macs might know better if this is even still needed, but there is an example of how to point to a branch in step 7:

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

So you would edit this line in your local version of discourse/Gemfile:

github.com

discourse/discourse/blob/main/Gemfile#L126


      
          gem "digest", require: false
          
          # Gems used only for assets and not required in production environments by default.
          # Allow everywhere for now cause we are allowing asset debugging in production
          group :assets do
            gem "uglifier"
          end
          
          group :test do
            gem "capybara", require: false
            gem "webmock", require: false
            gem "fakeweb", require: false
            gem "simplecov", require: false
            gem "selenium-webdriver", "~> 4.14", require: false
            gem "selenium-devtools", require: false
            gem "test-prof"
            gem "rails-dom-testing", require: false
            gem "minio_runner", require: false
          end
          
          group :test, :development do

and then run bundle install.

Decorbuz · 2021 年11 月 5 日 23:49

It’s linked right at the top of the original post.

The topic from the Ruby on Rails forum has been dead for many months now. The OP hasn’t been active since Feburary and hasn’t replied to any comments there asking for help.

There are more people to help me here. Just saying.

I tried copying that into Terminal and received the same Unknown command mini_racer, error from before.

Admittedly, the guide from the Ruby on Rails forum isn’t as clear as I’d hope in that regard.

Apologies in advance…

blake · 2021 年11 月 5 日 23:50

It’s not a command to run. You will need to EDIT the actual text file called “Gemfile” located inside the discourse directory.

Decorbuz · 2021 年11 月 5 日 23:54

Doh!

Thanks! Let me try that right now.

In my opinion, somebody should edit the guide from the Ruby on Rails forum and provide further clarification regarding step 7. Just my two cents though.

I will be right back. Hold on a second…

blake · 2021 年11 月 6 日 00:01

Sorry I have to run, but I think that mini_racer fix for m1 macs has been merged in. I just checked my Gemfile on my m1 mac and mine isn’t edited. So I think you can skip step 7.

Decorbuz · 2021 年11 月 6 日 00:04

I ran step 8 and received the Could not locate Gemfile error.

I (think) I was able to figure out step 7, but step 8 is still giving me trouble and is spitting out the error mentioned above.

blake · 2021 年11 月 6 日 13:10

运行 bundle install 时，您需要位于 discourse 目录下。

techAPJ:

克隆 Discourse

在 ~/discourse 文件夹中克隆 Discourse 仓库：
git clone https://github.com/discourse/discourse.git ~/discourse
~ 表示主文件夹，因此 Discourse 源代码将在您的主文件夹中可用。

引导 Discourse

切换到您的 Discourse 文件夹：
cd ~/discourse
安装所需的 gem
bundle install

JQ331 · 2021 年11 月 6 日 13:45

嗨 @merefield：您能多描述一下您的远程设置吗？

虽然开发主题允许我在实时网站上添加更改，但对于开发插件，我似乎别无选择，只能在我本地机器上进行，将整个 discourse 代码库放在那里（并在其之上放置我的插件）。

结果是，对于编码插件时的任何（非 CSS）更改，当我重新加载它时，1) 会启动我电脑的风扇，2) 需要整整 30 秒才能重新加载。如果我需要重启服务器，则需要几分钟。

这些延迟确实会累加——结果是我可能需要一个小时才能编写完一些东西，而按照我正常的编码流程（有热重载或每次更改最多 2-3 秒）只需要15 分钟。

所以，我很想听听任何加快速度的建议。

merefield · 2021 年11 月 6 日 15:09

这或许更适合放在 Ubuntu 主题上，因为我只是在云服务器上运行该安装，前面有 nginx 和完整的 DNS（无 docker），所以我实际上是在处理域名。一切都从终端运行。我甚至已经让 Ember CLI 在该设置中运行良好。

它也不是很快，但足够快。它的好处是可以运行和测试完整的 https 回调服务。

据我所知，目前最快的插件开发环境是本地的 Docker Dev on WSL2，它运行速度极快。它也非常容易维护。不幸的是，据我所知 discourse_theme 在该环境中还不能正常工作，所以我又回到了我的云服务器上进行这项工作。

苹果在这方面落后真是有点奇怪？微软的工程师们已经证明了他们非常精明。

Nacho_Caballero · 2021 年11 月 26 日 14:31

如果有人在安装 ruby 2.7.3 时遇到错误，显然 Xcode 12 之后的一些更改破坏了 rbenv 的安装过程：

github.com/rbenv/ruby-build

installing older Ruby versions on OSX after XCode 12

opened 03:28AM - 11 Nov 20 UTC

closed 04:10AM - 15 Apr 21 UTC

eddroid

_tldr_: This is an installation problem and solution. Maybe ya'll can do somethi…ng about this in `ruby-build` itself? Maybe not. In any case, it's here for the search bots. ### Problem ```sh $ rbenv install 2.1.7 ``` output ``` BUILD FAILED (Mac OS X 10.15.7 using ruby-build 20200926) Inspect or clean up the working tree at /var/folders/hk/6ghd603s4gggg2kpspf5jjth0000gn/T/ruby-build.20201110215242.31778.FSCdTL Results logged to /var/folders/hk/6ghd603s4gggg2kpspf5jjth0000gn/T/ruby-build.20201110215242.31778.log ``` end of logfile output ``` # ruby-build.20201110215242.31778.log 3 warnings and 4 errors generated. make[2]: *** [ossl_pkcs7.o] Error 1 make[1]: *** [ext/openssl/all] Error 2 make[1]: *** Waiting for unfinished jobs.... compiling objspace_dump.c installing default objspace libraries linking shared-object objspace.bundle linking shared-object nkf.bundle 13 warnings generated. linking shared-object date_core.bundle make: *** [build-ext] Error 2 ``` sample line from openssl extension [MakeMakefile](https://ruby-doc.org/stdlib-2.1.7/libdoc/mkmf/rdoc/MakeMakefile.html) log: ``` # <BUILD_DIR>/ruby-2.1.7/ext/openssl/mkmf.log conftest.c:13:15: error: implicit declaration of function 'OPENSSL_cleanse' is invalid in C99 [-Werror,-Wimplicit-function-declaration] ``` ### Solution ```sh $ CFLAGS="-Wno-error=implicit-function-declaration" rbenv install 2.1.7 ``` output: ``` Downloading openssl-1.0.2u.tar.gz... -> https://dqw8nmjcqpjn7.cloudfront.net/ecd0c6ffb493dd06707d38b14bb4d8c2288bb7033735606569d8f90f89669d16 Installing openssl-1.0.2u... Installed openssl-1.0.2u to /Users/***/.rbenv/versions/2.1.7 Downloading ruby-2.1.7.tar.bz2... -> https://cache.ruby-lang.org/pub/ruby/2.1/ruby-2.1.7.tar.bz2 Installing ruby-2.1.7... WARNING: ruby-2.1.7 is past its end of life and is now unsupported. It no longer receives bug fixes or critical security updates. ruby-build: using readline from homebrew Installed ruby-2.1.7 to /Users/***/.rbenv/versions/2.1.7 ``` ### Explanation [XCode 12 was released September 16, 2020.](https://en.wikipedia.org/wiki/Xcode#12.x_series) [Apple changed the default `CFLAGS` for `clang`.](https://developer.apple.com/documentation/xcode-release-notes/xcode-12-release-notes) > Clang now reports an error when you use a function without an explicit declaration when building C or Objective-C code for macOS (-Werror=implicit-function-declaration flag is on). This change prevents this version of Ruby (and possibly others) from compiling native extensions like `openssl` and `zlib`. Unfortunately, those errors only appear in the corresponding `mkmf.log` for the extensions. [This could also affect building some gems that use C code](https://github.com/macournoyer/thin/pull/364). ```sh gem install <GEMNAME> -- --with-cflags="-Wno-error=implicit-function-declaration" ```

尽管我已安装最新版本的 psych 和 libyaml，但仍收到此错误：

似乎您的 ruby 安装缺少 psych（用于 YAML 输出）。
要消除此警告，请安装 libyaml 并重新安装您的 ruby。

我尝试了指南中建议的解决方法，但仍然收到相同的错误，最后不得不使用 rvm：

rvm install 2.7.3

JQ331 · 2021 年12 月 9 日 17:50

关于如何更快地进行插件编程，我最近改变了我的方法。而且效果很好。基本上，将任何前端的东西移到一个主题组件中，只在插件本身中编写后端的东西。我知道其他人以前也发现了这一点。但现在我这样做了，编程速度更快，体验也更好。详情请参见此处。

话题		回复	浏览量
Install Discourse on Ubuntu or Debian for Development Developer Guides dev-install , how-to	84	193591	2025 年6 月 22 日
Install Discourse for development using Docker Developer Guides docker , dev-install , how-to	217	83825	2025 年9 月 8 日
When trying to upgrade: Error running ember build Installation	20	2557	2022 年4 月 9 日
Rebuild failing at "bundle exec rake db:migrate" Installation	1	4028	2018 年11 月 14 日
Can't start localhost server -- file was built for x86_64 which is not the architecture being linked (i386) Dev	11	2229	2022 年4 月 1 日