59 lines
2.5 KiB
Markdown
59 lines
2.5 KiB
Markdown
# 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.
|
|
|