Name: deck
Owner: Turing School of Software & Design
Description: null
Created: 2016-11-01 15:05:44.0
Updated: 2017-04-20 02:20:29.0
Pushed: 2016-11-10 15:58:59.0
Homepage: null
Size: 4595
Language: JavaScript
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
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.
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.
Any Rails application needs a web server with Ruby support first. We use Phusion Passenger (mod_rails
) ourselves, but you can also use Thin, Puma or Unicorn. Phusion Passenger can be installed for Nginx or Apache, you can chose wichever you like best. The installation differs depending on your distribution, so have a look at their Nginx installation manual or their Apache installation manual.
After setting up a webserver, you have to create a database for Brimir and modify the config file in config/database.yml
to reflect the details. Set your details under the production section. We advise to use adapter: postgresql
or adapter: mysql2
for production usage, because those are the only two adapters and database servers we test. If you plan to use MySQL, make sure you use utf8 as your charset and collation.
Next up: configuring your outgoing email address and url. This can be set in config/environments/production.rb
by adding the following lines before the keyword end
:
config.action_mailer.default_options = { from: 'brimir@yoururl.com' }
config.action_mailer.default_url_options = { host: 'brimir.yoururl.com' }
Now install the required gems by running the following command if you want PostgreSQL support:
bundle install --without sqlite mysql development test --deployment
Run the following command to install gems if you want MySQL support:
bundle install --without sqlite postgresql development test --deployment
Generate a secret_key_base in the secrets.yml file:
LINUX: sed -i "s/<%= ENV\[\"SECRET_KEY_BASE\"\] %>/`bin/rake secret`/g" config/secrets.yml
MAC: sed -i "" "s/<%= ENV\[\"SECRET_KEY_BASE\"\] %>/`bin/rake secret`/g" config/secrets.yml
Next, load the database schema and precompile assets:
bin/rake db:schema:load RAILS_ENV=production
bin/rake assets:precompile RAILS_ENV=production
If you want to use LDAP, configure config/ldap.yml accordingly, then change the auth strategy in your application config in file config/application.rb:
config.devise_authentication_strategy = :ldap_authenticatable
(Optional for LDAP) Last thing left to do before logging in is making a user and adding some statuses. You can do this by running:
bin/rails console production
u = User.new({ email: 'your@email.address', password: 'somepassword', password_confirmation: 'somepassword' }); u.agent = true; u.save!
First download the new code in the same directory by unpacking a release tarball or by running git pull
(when you cloned the repo earlier). After updating code run the following commands to install necessary gem updates, migrate the database and regenerate precompiled assets.
bundle install
bin/rake db:migrate RAILS_ENV=production
bin/rake assets:precompile RAILS_ENV=production
Don't forget to restart your application server (touch tmp/restart.txt
for Passenger).
Some applicant level configuration can be set through config/settings.yml
Brimir is available in several languages. By default, it will use the locale corresponding to the user browser agent, if it was among the supported locales. If you want to change this and force certain locale, you can do that by setting: ignore_user_agent_locale: true
in config/settings.yml
Incoming emails can be posted to the tickets url by using the script found in scripts/post-mail. Create an alias in your /etc/aliases
file like this:
brimir: "|/bin/sh /path/to/your/brimir/repo/script/post-mail http://yoururl.com/tickets.json"
Now sending an email to brimir@yoururl.com should start curl and post the email to your brimir installation.
We appreciate all contributions! If you would like to contribute, please follow these steps:
Some users have made requests for the following features. If you would like to contribute, you could add any of these.
Brimir is licensed under the GNU Affero General Public License Version 3.