Discourse: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(Add development setup docs)
(Setup redirect)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[File:Discourse logo.png|frameless|Discourse]]
#REDIRECT [[ParticipationSystems/Discourse]]
 
Discourse is a communication platform "for the next 10 years". It features a clean web interface, mailing list features and much more.
 
This page contains all the important details about and for the use, setup and development of Discourse within Mozilla.
 
= Current instances =
 
* [https://discourse.mozilla-community.org/ Mozilla Discourse]
* [https://discourse.mozilla-advocacy.org/ Mozilla Advocacy Community]
* [https://forum.learning.mozilla.org/ Mozilla Learning Forum]
 
= Documentation =
 
== Development ==
 
=== Setting up the development environment ===
 
The quickest and easiest way to get up and running with hacking on Discourse is using Vagrant, the following steps will download, provision and setup a development virtual machine for you.
 
Ensure you have Git, VirtualBox and Vagrant installed.
 
Open a terminal, and clone the Discourse repository with:
 
<pre>
git clone https://github.com/discourse/discourse.git
</pre>
 
Then enter the project directory:
 
<pre>
cd discourse
</pre>
 
To start downloading, provisioning and booting the VM, run:
 
<pre>
vagrant up
</pre>
 
This will take quite a while, so go grab a hot chocolate.
 
Once the VM has booted up, you can shell into it with:
 
<pre>
vagrant ssh
</pre>
 
Then enter the project directory, within the VM:
 
<pre>
cd /vagrant
</pre>
 
Install the required gems:
 
<pre>
bundle install
</pre>
 
Run the database migrations:
 
<pre>
bundle exec rake db:migrate
</pre>
 
Create an admin user:
<pre>
bundle exec rake admin:create
</pre>
 
And start the rails server:
<pre>
bundle exec rails s -b 0.0.0.0
</pre>
 
After a few seconds rails will start serving pages, and you should be able to access your Discourse instance at: http://localhost:4000
 
To log in as the admin user, navigate to:
 
<pre>
http://localhost:4000/session/<username>/become
</pre>
 
(replacing <code><username></code> with the admin username)

Latest revision as of 16:06, 10 January 2017