Go to file
Lucas Verney 338e84f72b Update for Phyks instance 2017-01-05 17:24:10 +01:00
.gitignore Ignore .vagrant folder 2017-01-05 17:21:46 +01:00
Procfile Comment dev lines in Procfile, closes #1 2017-01-05 17:22:31 +01:00
README.md Minor documentation changes 2015-12-15 08:35:35 +00:00
Vagrantfile Added semit-automated setup procedure via setup.sh, included timezones file for reference, some minor changes to the other files. 2015-12-12 17:59:21 +00:00
env Update for Phyks instance 2017-01-05 17:24:10 +01:00
huginn Initial commit, with files 2015-12-09 13:11:44 +00:00
provision.sh Update for Phyks instance 2017-01-05 17:24:10 +01:00

README.md

Huginn with Vagrant and VirtualBox

Based on instructions here:

https://github.com/cantino/huginn/blob/master/doc/manual/installation.md

Setup Huginn under VirtualBox, with minimal configuration required.

A working VirtualBox installation is a prerequisite, as well as Vagrant (from vagrantup.com).

Testing

This repository is pulled to my server and test-compiled each day, so I hope I will catch any problems due to up-stream changes in the Huginn project itself. Email burns dot sj at gmail dot com if I missed anything or if you find any other problems.

Guided Installation

If you know the settings you will use for your Huginn installation (such as SMTP host, MySQL settings, etc) you can:

  • Clone this repository: git clone https://github.com/m0nty/huginn-vagrant.git
  • Jump straight in with ./setup.sh and follow the prompts. No attempt is made to validate your input while you do this, but sensible defaults are suggested for usernames, passwords, etc.
  • Run vagrant up to provision your Huginn instance.

Manually Editing the Config Files

You do not need to do this if you successfully ran ./setup.sh above. But, if you prefer to edit the config files yourself or you need to correct a setting:

  • Clone this repository: git clone https://github.com/m0nty/huginn-vagrant.git
  • Edit the env file, which will be copied to /home/huginn/huginn/.env (look for the FIXME comments in the file to see what you need to adjust).
  • Edit provision.sh and change the MySQL passwords for the root MySQL user and the Huginn DB user (search for FIXME again).
  • Edit the Vagrantfile if you want to change the virtual machine settings. I've gone with vb.memory = "1024" which you might want to increase if you think your Huginn is going to be busier.
  • You might want to change the line config.vm.box = "ubuntu/trusty64" if your PC can't run 64-bit images.
  • Edit the huginn file if you want to change the listening address and port for your Huginn instance.
  • I don't think you need to change the Procfile, but you may as well check anyway.
  • After that, run vagrant up to provision your Huginn instance.

Please let me know if I've messed up in any way. I've got my Huginn instance working now, and I'm delighted with it. I just wanted to help out if anyone else is having problems with the other installation methods.

To-do

I'll probably do a Dockerfile sometime, so you can create a docker instance yourself without pulling the Huginn docker image.