Huginn

Key Features

• Agent-based automation architecture with 50+ built-in agent types including RSS, web scraping, email, webhooks, and API integrations
• Visual scenario builder for creating complex multi-step workflows that chain agents together with conditional logic
• Real-time event streaming and processing with configurable scheduling from minutes to months
• Custom JavaScript execution environment for data transformation and advanced logic operations
• Web-based management interface with agent monitoring, event logging, and debugging tools
• MySQL-powered event history and agent state persistence with configurable retention policies
• Built-in credential management system for securely storing API keys and authentication tokens
• Liquid templating engine for dynamic content generation and data formatting across agents

Common Use Cases

• 1Home automation monitoring by tracking IoT device APIs and triggering notifications or actions based on sensor readings
• 2Competitive intelligence gathering through automated web scraping of competitor websites and price monitoring
• 3Social media content aggregation and cross-posting by monitoring multiple platforms and reposting relevant content
• 4IT infrastructure monitoring with custom agents that check service availability and send alerts via multiple channels
• 5E-commerce inventory management by monitoring supplier APIs and automatically updating product availability
• 6Research and journalism workflows that track news sources, filter content, and compile reports automatically
• 7Personal productivity automation including email filtering, calendar management, and task creation from various triggers

Prerequisites

• Docker and Docker Compose installed with at least 2GB available RAM for MySQL and Huginn containers
• Port 3000 available for Huginn web interface access and basic understanding of web-based administration
• Environment variables configured for database credentials including DB_NAME, DB_USER, DB_PASSWORD, and DB_ROOT_PASSWORD
• Basic knowledge of agent concepts, webhooks, and API interactions for effective automation workflow creation
• Understanding of Liquid templating syntax for advanced data transformation between agents
• Familiarity with cron-like scheduling expressions for configuring agent execution intervals

docker-compose.yml

1services: 
2  huginn: 
3    image: huginn/huginn:latest
4    container_name: huginn
5    restart: unless-stopped
6    environment: 
7      MYSQL_PORT_3306_TCP_ADDR: mysql
8      HUGINN_DATABASE_NAME: ${DB_NAME}
9      HUGINN_DATABASE_USERNAME: ${DB_USER}
10      HUGINN_DATABASE_PASSWORD: ${DB_PASSWORD}
11    ports: 
12      - "3000:3000"
13    depends_on: 
14      - mysql
15    networks: 
16      - huginn
17
18  mysql: 
19    image: mysql:8.0
20    container_name: huginn-mysql
21    environment: 
22      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
23      MYSQL_DATABASE: ${DB_NAME}
24      MYSQL_USER: ${DB_USER}
25      MYSQL_PASSWORD: ${DB_PASSWORD}
26    volumes: 
27      - mysql_data:/var/lib/mysql
28    networks: 
29      - huginn
30
31volumes: 
32  mysql_data: 
33
34networks: 
35  huginn: 
36    driver: bridge

.env Template

1DB_ROOT_PASSWORD=rootpassword
2DB_NAME=huginn
3DB_USER=huginn
4DB_PASSWORD=changeme

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

huginn:
  image: huginn/huginn:latest
  container_name: huginn
  restart: unless-stopped
  environment:
    MYSQL_PORT_3306_TCP_ADDR: mysql
    HUGINN_DATABASE_NAME: ${DB_NAME}
    HUGINN_DATABASE_USERNAME: ${DB_USER}
    HUGINN_DATABASE_PASSWORD: ${DB_PASSWORD}
  ports:
    - "3000:3000"
  depends_on:
    - mysql
  networks:
    - huginn

mysql:
  image: mysql:8.0
  container_name: huginn-mysql
  environment:
    MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
    MYSQL_DATABASE: ${DB_NAME}
    MYSQL_USER: ${DB_USER}
    MYSQL_PASSWORD: ${DB_PASSWORD}
  volumes:
    - mysql_data:/var/lib/mysql
  networks:
    - huginn

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  huginn:
5    image: huginn/huginn:latest
6    container_name: huginn
7    restart: unless-stopped
8    environment:
9      MYSQL_PORT_3306_TCP_ADDR: mysql
10      HUGINN_DATABASE_NAME: ${DB_NAME}
11      HUGINN_DATABASE_USERNAME: ${DB_USER}
12      HUGINN_DATABASE_PASSWORD: ${DB_PASSWORD}
13    ports:
14      - "3000:3000"
15    depends_on:
16      - mysql
17    networks:
18      - huginn
19
20  mysql:
21    image: mysql:8.0
22    container_name: huginn-mysql
23    environment:
24      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
25      MYSQL_DATABASE: ${DB_NAME}
26      MYSQL_USER: ${DB_USER}
27      MYSQL_PASSWORD: ${DB_PASSWORD}
28    volumes:
29      - mysql_data:/var/lib/mysql
30    networks:
31      - huginn
32
33volumes:
34  mysql_data:
35
36networks:
37  huginn:
38    driver: bridge
39EOF
40
41# 2. Create the .env file
42cat > .env << 'EOF'
43DB_ROOT_PASSWORD=rootpassword
44DB_NAME=huginn
45DB_USER=huginn
46DB_PASSWORD=changeme
47EOF
48
49# 3. Start the services
50docker compose up -d
51
52# 4. View logs
53docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/huginn/run | bash

Troubleshooting