Moebooru

An image board.

• Source Repository

Requirements

As this is ongoing project, there will be more changes on requirement as this project goes. Currently this application is developed using:

• Ruby (2.6 or later)
• PostgreSQL (11 or later)
• Bundler gem
• node.js (10.17 or later)
• yarn
• ImageMagick
• And various other requirement for the gems (check Gemfile for the list)

On RHEL5 (and 6), it goes like this (outdated list):

• gcc
• gcc-c++
• ImageMagick
• jhead
• libxslt-devel
• libyaml-devel
• git
• openssl-devel
• pcre-devel
• postgresql94-devel
• postgresql94-server
• readline-devel

Base, EPEL, and postgresql official repositories contain all the requirements.

Installation

Database Setup

After initializing PostgreSQL database, create user for moebooru with createdb privilege:

postgres# create user moebooru_user with password 'the_password' createdb;

Rails Setup

• Run bundle install
• Create config/database.yml and config/local_config.rb
• Initialize database with bundle exec rake db:reset
• Run bundle exec rake db:migrate
• Start the server (bundle exec unicorn or bundle exec puma if using JRuby/Rubinius)

Configuration

See config/local_config.rb.example. Additionally, as I move to ENV-based configuration, here's the list of currently supported ENV variables:

• MB_DATABASE_URL: sets database connection configuration. Syntax: postgres://<user>(:<pass>)@<host>(:<port>)/<dbname>.
• MB_MEMCACHE_SERVERS: addresses of memcache servers. Separated by comma.
• MB_PIWIK_HOST: sets the host this application will attempt to contact a Piwik installation at. Defaults to false to not use Piwik if unset.
• MB_PIWIK_ID: sets the Site ID this application will send analytics data for.
• MB_THREADS: sets number of threads this application is running. Currently used to determine number of connection pool for memcached. Defaults to 1 if unset.

Additional configuration for web server

On setup with separate image servers, additional configuration is required for avatar and inline image cropping to work. Specifically, due to how the image cropping library works, the image servers need to allow CORS for image access from main url.

Plans

• Bug fixes
• Documentation
• And more!