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 (3.3 or later)
• PostgreSQL (15 or later)
• Bundler gem
• node.js (20.0 or later)
• ImageMagick
• And various other requirement for the gems (check Gemfile for the list)

On RHEL, it goes like this (untested):

• ImageMagick
• gcc
• gcc-c++
• git
• jhead
• libxslt-devel
• libyaml-devel
• nodejs
• openssl-devel
• pcre-devel
• postgresql15-devel
• postgresql15-server

Base, EPEL, dnf module, 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 (development)

• 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 rails server)
• Start asset builder server (npm run build -- --watch)

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.

Plans

• Bug fixes
• Documentation
• And more!