huginn/doc/docker/install.md

Why run Huginn with docker

You can play with or deploy Huginn inside of docker.

Getting Huginn up and running using docker is quick and painless once you have docker installed. The docker container is suitable for production and evaluation. Huginn uses environmental variables for configuration, so rather than having a .env file, the Docker container expects variables to be passed into the launch command.

Running the Container

Quick start to check out Huginn

OSX GUI using Kitematic

1. Download and install Kitematic
2. Start Kitematic and search for cantino/huginn
3. Click create and wait for the container to be downloaded and booted
4. Click on the link icon next to 'WEB PREVIEW'
5. Log in to your Huginn instance using the username admin and password password

OSX/Windows/Linux using docker machine

1. Download docker machine for your OS
2. Follow the installation instructions untill you can successfully run docker ps
3. Get the the IP of the VM running docker by running docker-machine ls
4. Start your Huginn container using docker run -it -p 3000:3000 cantino/huginn
5. Open Huginn in the browser http://docker-machine ip:3000
6. Log in to your Huginn instance using the username admin and password password

Linux

1. Install docker using the install instructions
2. Start your Huginn container using docker run -it -p 3000:3000 cantino/huginn
3. Open Huginn in the browser http://localhost:3000
4. Log in to your Huginn instance using the username admin and password password

Configuration and linking to a database container

Follow the instructions on the docker hub registry on how to configure Huginn using environment variables and linking the container to an external MySQL or PostgreSQL database.

Running each Huginn process in a seperate container

With the cantino/huginn-single-process image you can easily run each process needed for Huginn in a separate container and scale them individually when needed. Have a look at the Docker hub and the documentation for the container

Other options:

Other Docker options:

• If you don't want to use the official repo, see also: https://registry.hub.docker.com/u/andrewcurioso/huginn/
• If you'd like to run Huginn's web process and job worker process in separate containers, another option is https://github.com/hackedu/huginn-docker. It also uses Unicorn as the web server and serves precompiled assets.