Lobsters Rails Project
This is the source code to the site operating at https://lobste.rs. It is a Rails 3 codebase and uses a SQL (MySQL in production) backend for the database and Sphinx for the search engine.
Install Ruby 1.9.3.
Checkout the lobsters git tree from Github
$ git clone git://github.com/jcs/lobsters.git $ cd lobsters lobsters$
Run Bundler to install/bundle gems needed by the project:
Create a MySQL (other DBs supported by ActiveRecord may work, only MySQL has been tested) database, username, and password and put them in a
development: adapter: mysql2 encoding: utf8 reconnect: false database: lobsters_dev socket: /tmp/mysql.sock username: *username* password: *password* test: adapter: sqlite3 database: db/test.sqlite3 pool: 5 timeout: 5000
Load the schema into the new database:
lobsters$ rake db:schema:load
config/initializers/secret_token.rbfile, using a randomly generated key from the output of
Lobsters::Application.config.secret_token = 'your random secret here'
(Optional, only needed for the search engine) Install Sphinx. Build Sphinx config and start server:
lobsters$ rake thinking_sphinx:rebuild
Create an initial administrator user and at least one tag:
lobsters$ rails console Loading development environment (Rails 3.2.6) irb(main):001:0> u = User.new(:username => "test", :email => "email@example.com", :password => "test") irb(main):002:0> u.is_admin = true irb(main):003:0> u.is_moderator = true irb(main):004:0> u.save irb(main):005:0> t = Tag.new irb(main):006:0> t.tag = "test" irb(main):007:0> t.save
The default development hostname is defined as
lobsters.localhost:3000. You should define this in
/etc/hosts(or through DNS) to point to
Run the Rails server in development mode. You should be able to login to
lobsters$ rails server
Contributing bugfixes and new features
Please see the CONTRIBUTING file.