How to deploy Huginn on my own server without docker

February 21, 2016 970 views
Deployment Ruby on Rails Nginx Ubuntu

I would like to try using Huginn - a rails app that acts as a self-hosted "if this than that" app.

So far it seems like there are two options:

  1. Spin up the Docker one-click and then follow this huginn on docker guide
  2. Manually install Huginn on a regular Ubuntu server.

I tried the Docker approach and ran into issues where a server reboot caused complete data-loss. Has anyone manually installed huginn on a DigitalOcean droplet?

2 Answers

Answering my own question...

Here's what ended up working. This is heavily reliant on the manual install guide, just customized to be easier on a 1GB DigitalOcean droplet.

user-scripts shortcut:

I bundled as much of Huginn's dependencies into a cloud-config script that you can add when spinning up the droplet, just paste this into the User-Script section of the droplet create form:

  - name: huginn
    groups: sudo
    shell: /bin/bash
    sudo: ['ALL=(ALL) NOPASSWD:ALL']
  - apt-get update -y
  - apt-get upgrade -y
  - apt-get install -y runit build-essential git zlib1g-dev libyaml-dev libssl-dev libgdbm-dev libreadline-dev libncurses5-dev libffi-dev curl openssh-server checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libicu-dev logrotate python-docutils pkg-config cmake nodejs graphviz nginx
  - apt-get remove -y ruby1.8 ruby1.9
  - mkdir /tmp/ruby && cd /tmp/ruby
  - curl -L --progress | tar xj
  - cd ruby-2.2.3
  - ./configure --disable-install-rdoc
  - make -j`nproc`
  - sudo make install
  - sudo gem install bundler foreman --no-ri --no-rdoc
  - curl -X POST -d number=YOURPHONENUMBERHERE -d "message=Done initializing huginn"

users block: Creates a user huginn with sudo access, add your public key if you'd like to SSH in as huginn instead of root.

runcmd block: apt-get updates and upgrades your server, installs as many of the Huginn dependencies as possible in one go. We need Ruby 2.2.3, so we bypass the standard apt-get process and download, compile and install ruby directly from source. Finally bundler and foreman are installed via gem install.

All this is going to take a while, so I end the script with a neat little hack to send me a text message when it's done! Replace YOURPHONENUMBERHERE with your phone #.

Finish install

Once you get the text, SSH in as root and wrap up the install with the following commands:


cd /home/huginn
sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev
sudo mysql_secure_installation

Follow mySQL prompts to set password, then follow the prompts to lock down the install by running mysql_secure_installation. Login to mySQL with the password you just set and create the user huginn with a unique password.

mysql -u root -p

SET storage_engine=INNODB;
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, LOCK TABLES ON `huginn_production`.* TO 'huginn'@'localhost';

Clone huginn source from github

This differs slightly from the manual install guide, I planned on making some of my own changes to huginn, so I forked it on github and then cloned my fork instead of cloning the master.

# We'll install Huginn into the home directory of the user "huginn"
cd /home/huginn

# Clone your fork of the huginn repo
sudo -u huginn -H git clone -b master huginn
cd huginn
# add the original upstream so you can get updates
git remote add upstream

# Copy the example Huginn config
sudo -u huginn -H cp .env.example .env

# Create the log/, tmp/pids/ and tmp/sockets/ directories
sudo -u huginn mkdir -p log tmp/pids tmp/sockets

# Make sure Huginn can write to the log/ and tmp/ directories
sudo chown -R huginn log/ tmp/
sudo chmod -R u+rwX,go-w log/ tmp/

# Make sure permissions are set correctly
sudo chmod -R u+rwX,go-w log/
sudo chmod -R u+rwX tmp/
sudo -u huginn -H chmod o-rwx .env

# Copy the example Unicorn config
sudo -u huginn -H cp config/unicorn.rb.example config/unicorn.rb

Configure Huginn in .env and config/unicorn.rb files

Open the .env config file in default editor

sudo -u huginn -H editor .env

Change, the secret token, set the mysql specs we just defined, set env=production:




I also edited config/unicorn.rb to only run one worker_process, which is recommended when your server has less than 2GB RAM.

sudo -u huginn -H editor config/unicorn.rb

then edit the workerprocesses to 1_

worker_processes 1

Install Gems to run huginn in production mode

sudo -u huginn -H bundle install --deployment --without development test

Initialize Database

sudo -u huginn -H bundle exec rake db:create RAILS_ENV=production
sudo -u huginn -H bundle exec rake db:migrate RAILS_ENV=production
sudo -u huginn -H bundle exec rake db:seed RAILS_ENV=production

Compile Assets / Install Init / Logrotate

sudo -u huginn -H bundle exec rake assets:precompile RAILS_ENV=production
sudo -u huginn -H editor Procfile

in the Procfile, comment out the web: and jobs: lines in the development section, and uncomment them in the production section. Then export and setup logrotate:

sudo bundle exec rake production:export
sudo cp deployment/logrotate/huginn /etc/logrotate.d/huginn

Configure nginx
This assumes huginn is the only web app running on the server, copy the nginx config to /etc/nginx/sites-enabled directory and remove the default config:

sudo cp deployment/nginx/huginn /etc/nginx/sites-available/huginn
sudo ln -s /etc/nginx/sites-available/huginn /etc/nginx/sites-enabled/huginn
sudo rm /etc/nginx/sites-enabled/default

If you have a domain pointing to this droplet, specify it on the server_name line of the nginx config:

sudo editor /etc/nginx/sites-available/huginn

Finally test the new nginx config and restart if it passes:

sudo nginx -t
sudo service nginx restart

Now you can go to your domain or IP address and login with credentials: admin and password and start using huginn!

If someone can figure out how to bundle everything into a cloud-init script that would be amazing.

Have another answer? Share your knowledge.