How to Install Frab on Void Linux

Frab is a conference management and planning web application developed using Ruby on Rails. In this tutorial, we will learn how to install Frab on Void Linux.

Prerequisites

Before starting, make sure that you have the following prerequisites:

• A working installation of Void Linux
• Basic knowledge of the command-line interface
• Root or sudo permissions

Install Dependencies

Frab requires some dependencies to be installed before we can install Frab:

sudo xbps-install -S git gcc make ruby ruby-bundler ruby-dev sqlite-devel zlib-devel libxml2-devel libxslt-devel mariadb mariadb-client mariadb-dev

Clone the Frab Repository

Next, we need to clone the Frab repository:

git clone https://github.com/frab/frab.git
cd frab

Install Ruby Gems

Now, let's install the required Ruby gems:

bundle install --path vendor/bundle

Configure Frab

Frab comes with a sample configuration file. You can copy it and modify it as needed:

cp config/settings.yml.sample config/settings.yml

Edit the configuration file config/settings.yml:

default:
  bulletins:
    sender_email: [email protected]
  email:
    from_email: [email protected]
    locale: en
    smtp:
      address: smtp.example.com
      port: 587
      domain: example.com
      user_name: [email protected]
      password: secret
  event:
    title: My Awesome Conference
    acronyms: MAC2021
    timezone: Europe/Berlin
    color: blue
    ticketserver_url: https://tickets.example.com
    feedback_enabled: true
  feedback:
    email:
      enabled: false
      to_email: [email protected]
      from_email: [email protected]
      subject: "My Awesome Conference - Feedback"
  maps:
    provider: osm
    static_maps_provider: staticmaps
  scheduling:
    default_timeslots:
      - '09:00'
      - '11:00'
      - '13:00'
      - '15:00'
      - '17:00'
    use_tracks: true
  talk:
    proposal_keywords: true
    proposal_private: false
    speaker_info: true
  track:
    colors:
      blue: '#3480D7'
      green: '#49B049'
      gray: '#D8D8D8'
      purple: '#5b3ca3'
      red: '#FC574E'
      yellow: '#FFC825'

Initialize the Database

Now we need to initialize the database:

RAILS_ENV="production" bundle exec rake db:create db:migrate db:seed_fu

Start the Server

Finally, to start the Frab server, run:

bundle exec rails server -e production

By default, Frab listens on port 3000. You can access the Frab server on your local machine by browsing to http://localhost:3000.

Conclusion

In this tutorial, we learned how to install Frab on Void Linux. Now, you can start using Frab to manage and plan your conferences!