2013-02-12 11:18:59 -05:00
# Discourse Advanced Developer Install Guide
2018-04-04 16:04:31 -04:00
This guide is aimed at advanced Rails developers who have installed their own Rails apps before.
2013-08-24 07:31:02 -04:00
Note: If you are developing on a Mac, you will probably want to look at [these instructions ](DEVELOPMENT-OSX-NATIVE.md ) as well.
2013-02-12 11:18:59 -05:00
2016-06-01 14:42:05 -04:00
# Preparing a fresh Ubuntu install
2018-10-01 00:28:16 -04:00
To get your Ubuntu 16.04 or 18.04 LTS install up and running to develop Discourse and Discourse plugins follow the commands below. We assume an English install of Ubuntu.
2016-06-01 14:42:05 -04:00
# Basics
whoami > /tmp/username
sudo add-apt-repository ppa:chris-lea/redis-server
sudo apt-get -yqq update
2018-10-01 00:12:52 -04:00
sudo apt-get -yqq install python-software-properties vim curl expect debconf-utils git-core build-essential zlib1g-dev libssl-dev openssl libcurl4-openssl-dev libreadline6-dev libpcre3 libpcre3-dev imagemagick redis-server advancecomp gifsicle jhead jpegoptim libjpeg-turbo-progs optipng pngcrush pngquant gnupg2
2016-06-01 14:42:05 -04:00
# Ruby
curl -sSL https://rvm.io/mpapis.asc | gpg2 --import -
2016-06-02 13:06:04 -04:00
curl -sSL https://get.rvm.io | bash -s stable
2016-06-01 14:42:05 -04:00
echo 'gem: --no-document' >> ~/.gemrc
2016-06-02 13:06:04 -04:00
2017-07-31 05:09:09 -04:00
# exit the terminal and open it again to activate RVM
2016-06-02 13:06:04 -04:00
2019-03-22 00:00:04 -04:00
rvm install 2.6.2
rvm --default use 2.6.2 # If this error out check https://rvm.io/integration/gnome-terminal
2018-07-30 23:18:27 -04:00
gem install bundler mailcatcher rake
2016-06-01 14:42:05 -04:00
2018-10-01 00:12:52 -04:00
# Download and install postgresql-10 from https://wiki.postgresql.org/wiki/Apt
2016-06-01 14:42:05 -04:00
# Postgresql
2017-10-03 10:25:08 -04:00
sudo -u postgres -i
createuser --superuser -Upostgres $(cat /tmp/username)
2016-06-01 14:42:05 -04:00
psql -c "ALTER USER $(cat /tmp/username) WITH PASSWORD 'password';"
2016-06-02 13:06:04 -04:00
exit
2013-02-12 11:18:59 -05:00
2016-06-01 14:42:05 -04:00
# Node
2017-07-31 05:09:09 -04:00
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash
# exit the terminal and open it again to activate NVM
nvm install node
nvm alias default node
2017-12-19 02:59:41 -05:00
npm install -g svgo
2013-02-12 11:18:59 -05:00
2014-06-03 19:18:32 -04:00
2016-06-01 14:42:05 -04:00
If everything goes alright, let's clone Discourse and start hacking:
2014-06-03 19:18:32 -04:00
2016-06-01 14:42:05 -04:00
git clone https://github.com/discourse/discourse.git ~/discourse
cd ~/discourse
bundle install
2017-10-03 10:25:08 -04:00
# run this if there was a pre-existing database
bundle exec rake db:drop
RAILS_ENV=test bundle exec rake db:drop
# time to create the database and run migrations
2019-09-18 10:09:17 -04:00
bundle exec rake db:create
bundle exec rake db:migrate
2017-10-03 10:25:08 -04:00
RAILS_ENV=test bundle exec rake db:create db:migrate
2017-12-19 02:59:41 -05:00
2017-07-31 05:09:09 -04:00
# run the specs (optional)
bundle exec rake autospec # CTRL + C to stop
2017-12-19 02:59:41 -05:00
2017-07-31 05:09:09 -04:00
# launch discourse
bundle exec rails s -b 0.0.0.0 # open browser on http://localhost:3000 and you should see Discourse
2013-03-24 23:49:22 -04:00
2017-10-02 18:08:07 -04:00
Create an admin account with:
2014-07-01 10:12:52 -04:00
2017-10-02 18:08:07 -04:00
bundle exec rake admin:create
2014-07-01 10:12:52 -04:00
2017-10-03 10:25:08 -04:00
If you ever need to recreate your database:
bundle exec rake db:drop db:create db:migrate
bundle exec rake admin:create
RAILS_ENV=test bundle exec rake db:drop db:create db:migrate
2016-06-01 14:42:05 -04:00
Discourse does a lot of stuff async, so it's better to run sidekiq even on development mode:
2013-03-24 23:49:22 -04:00
2017-10-02 18:12:35 -04:00
mailcatcher # open http://localhost:1080 to see the emails, stop with pkill -f mailcatcher
2017-07-25 02:55:22 -04:00
bundle exec sidekiq # open http://localhost:3000/sidekiq to see queues
2016-06-01 14:42:05 -04:00
bundle exec rails server
2013-03-24 23:49:22 -04:00
2016-06-01 14:42:05 -04:00
And happy hacking!