Email helpdesk built using Ruby on Rails and Zurb Foundation
Switch branches/tags
Nothing to show
Pull request Compare This branch is 1114 commits behind ivaldi:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
config
db
lib
log
public
script
test
vendor
.gitignore
.travis.yml
Gemfile
Gemfile.lock
LICENSE
README.md
Rakefile
config.ru

README.md

Brimir Build Status Coverage Status

Brimir is a simple helpdesk system that can be used to handle support requests via incoming email. Brimir is currently used in production at Ivaldi.

Installation

Brimir is a rather simple Ruby on Rails application. The only difficulty in setting things up is how to get incoming email to work. See the next section for details.

To install brimir you first have to create a database and modify the config file in config/database.yml to reflect the details.

Now install the required gems by running:

bundle install --without development:test

Next, load the database schema and some defaults:

rake db:migrate

Last thing left to do before logging in is making a user and adding some statuses. You can do this by running:

rails console
Status.create([ { name: 'Open', default: true }, { name: 'Closed' }, { name: 'Deleted' } ])
Priority.create([ { name: 'None', default: true }, { name: 'Low' }, { name: 'Medium' }, { name: 'High' } ])
u = User.new({ email: 'your@email.address', password: 'somepassword', password_confirmation: 'somepassword' }); u.agent = true; u.save!

Incoming email

Incoming emails can be posted to the tickets url. First make a script like this on your mailserver:

#!/bin/bash
exec curl --data-urlencode message@- https://yourbrimirurl.com/tickets

Save it in /etc/postfix/brimir.sh for example.

Next, create an alias in your /etc/aliases file like this:

brimir: "|/bin/bash /etc/postfix/brimir.sh"

Now sending an email to brimir@yourmailserver.com should start curl and post the email to your brimir installation.

License

Brimir is licensed under the GNU Affero General Public License Version 3.