150 lines
5.6 KiB
Markdown
150 lines
5.6 KiB
Markdown
# Discourse Advanced Developer Install Guide
|
|
|
|
This guide is aimed at advanced Rails developers who have installed their own Rails apps before. If you are new to Rails, you are likely much better off with our **[Discourse Vagrant Developer Guide](VAGRANT.md)**.
|
|
|
|
Note: If you are developing on a Mac, you will probably want to look at [these instructions](DEVELOPMENT-OSX-NATIVE.md) as well.
|
|
|
|
## First Steps
|
|
|
|
1. Install and configure PostgreSQL 9.1+.
|
|
1. Run `postgres -V` to see if you already have it.
|
|
1. Make sure that the server's messages language is English; this is [required](https://github.com/rails/rails/blob/3006c59bc7a50c925f6b744447f1d94533a64241/activerecord/lib/active_record/connection_adapters/postgresql_adapter.rb#L1140) by the ActiveRecord Postgres adapter.
|
|
2. Install and configure Redis 2+.
|
|
1. Run `redis-server -v` to see if you already have it.
|
|
3. Install ImageMagick
|
|
4. Install libxml2, g++, and make.
|
|
5. Install Ruby 1.9.3 and Bundler.
|
|
6. Clone the project and bundle.
|
|
7. Copy `config/database.yml.development-sample` to `config/database.yml`. Copy `config/redis.yml.sample` to `config/redis.yml`. Edit the files to point to your postgres and redis instances.
|
|
8. Create the "vagrant" user and the development and test databases in postgres. See the postgres section in "Building your own Vagrant VM", below.
|
|
|
|
|
|
## Before you start Rails
|
|
|
|
1. `bundle install`
|
|
2. `bundle exec rake db:create db:migrate db:test:prepare db:seed_fu`
|
|
4. Try running the specs: `bundle exec rake autospec`
|
|
5. `bundle exec rails server`
|
|
|
|
You should now be able to connect to rails on [http://localhost:3000](http://localhost:3000) - try it out! The seed data includes a pinned topic that explains how to get an admin account, so start there! Happy hacking!
|
|
|
|
|
|
# Building your own Vagrant VM
|
|
|
|
Here are the steps we used to create the **[Vagrant Virtual Machine](VAGRANT.md)**. They might be useful if you plan on setting up an environment from scratch on Linux:
|
|
|
|
|
|
## Base box
|
|
|
|
Vagrant version 1.1.2. With this Vagrantfile:
|
|
|
|
Vagrant::Config.run do |config|
|
|
config.vm.box = 'precise32'
|
|
config.vm.box_url = 'http://files.vagrantup.com/precise32.box'
|
|
config.vm.network :hostonly, '192.168.10.200'
|
|
|
|
if RUBY_PLATFORM =~ /darwin/
|
|
config.vm.share_folder("v-root", "/vagrant", ".", :nfs => true)
|
|
end
|
|
end
|
|
|
|
vagrant up
|
|
vagrant ssh
|
|
|
|
## Some basic setup:
|
|
|
|
sudo su -
|
|
ln -sf /usr/share/zoneinfo/Canada/Eastern /etc/localtime
|
|
apt-get -yqq update
|
|
apt-get -yqq install python-software-properties
|
|
apt-get -yqq install vim curl expect debconf-utils git-core build-essential zlib1g-dev libssl-dev openssl libcurl4-openssl-dev libreadline6-dev libpcre3 libpcre3-dev imagemagick
|
|
|
|
## Unicode
|
|
|
|
echo "export LANGUAGE=en_US.UTF-8" >> /etc/bash.bashrc
|
|
echo "export LANG=en_US.UTF-8" >> /etc/bash.bashrc
|
|
echo "export LC_ALL=en_US.UTF-8" >> /etc/bash.bashrc
|
|
export LANGUAGE=en_US.UTF-8
|
|
export LANG=en_US.UTF-8
|
|
export LC_ALL=en_US.UTF-8
|
|
|
|
locale-gen en_US.UTF-8
|
|
dpkg-reconfigure locales
|
|
|
|
## RVM and Ruby
|
|
|
|
apt-get -yqq install libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev ncurses-dev automake libtool bison subversion pkg-config curl build-essential git
|
|
|
|
su - vagrant -c "sudo bash -s stable < <(curl -s https://raw.github.com/wayneeseguin/rvm/master/binscripts/rvm-installer)"
|
|
adduser vagrant rvm
|
|
source /etc/profile.d/rvm.sh
|
|
su - vagrant -c "rvm pkg install libyaml"
|
|
su - vagrant -c "rvm install 2.0.0-turbo"
|
|
su - vagrant -c "rvm use 2.0.0-turbo --default"
|
|
|
|
echo "gem: --no-document" >> /etc/gemrc
|
|
su - vagrant -c "echo 'gem: --no-document' >> ~/.gemrc"
|
|
|
|
## Postgres 9.1
|
|
|
|
Configure so that the vagrant user doesn't need to provide username and password.
|
|
|
|
apt-get -yqq install postgresql postgresql-contrib-9.1 libpq-dev postgresql-server-dev-9.1
|
|
su - postgres
|
|
createuser --createdb --superuser -Upostgres vagrant
|
|
psql -c "ALTER USER vagrant WITH PASSWORD 'password';"
|
|
psql -c "create database discourse_development owner vagrant encoding 'UTF8' TEMPLATE template0;"
|
|
psql -c "create database discourse_test owner vagrant encoding 'UTF8' TEMPLATE template0;"
|
|
psql -d discourse_development -c "CREATE EXTENSION hstore;"
|
|
psql -d discourse_development -c "CREATE EXTENSION pg_trgm;"
|
|
|
|
|
|
Edit /etc/postgresql/9.1/main/pg_hba.conf to have this:
|
|
|
|
local all all trust
|
|
host all all 127.0.0.1/32 trust
|
|
host all all ::1/128 trust
|
|
host all all 0.0.0.0/0 trust # wide-open
|
|
|
|
## Redis
|
|
|
|
sudo su -
|
|
mkdir /tmp/redis_install
|
|
cd /tmp/redis_install
|
|
wget http://redis.googlecode.com/files/redis-2.6.7.tar.gz
|
|
tar xvf redis-2.6.7.tar.gz
|
|
cd redis-2.6.7
|
|
make
|
|
make install
|
|
cd utils
|
|
./install_server.sh
|
|
# Press enter to accept all the defaults
|
|
/etc/init.d/redis_6379 start
|
|
|
|
## Sending email (SMTP)
|
|
|
|
By default, development.rb will attempt to connect locally to send email.
|
|
|
|
```rb
|
|
config.action_mailer.smtp_settings = { address: "localhost", port: 1025 }
|
|
```
|
|
|
|
Set up [MailCatcher](https://github.com/sj26/mailcatcher) so the app can intercept
|
|
outbound email and you can verify what is being sent.
|
|
|
|
Note also that mail is sent asynchronously by Sidekiq, so you'll need to have it running to process jobs. Run it with this command:
|
|
|
|
```
|
|
bundle exec sidekiq
|
|
```
|
|
|
|
## Phantomjs
|
|
|
|
Needed to run javascript tests.
|
|
|
|
cd /usr/local/share
|
|
wget https://phantomjs.googlecode.com/files/phantomjs-1.8.2-linux-i686.tar.bz2
|
|
tar xvf phantomjs-1.8.2-linux-i686.tar.bz2
|
|
rm phantomjs-1.8.2-linux-i686.tar.bz2
|
|
ln -s /usr/local/share/phantomjs-1.8.2-linux-i686/bin/phantomjs /usr/local/bin/phantomjs
|