ieferrari/dagu_python repository overview

⁠Dagu + Python Runtime Image

A lightweight Docker image combining:

• Dagu workflow scheduler
• Python (slim base image)
• Non-root runtime
• Ready for cron-style orchestration of Python scripts

⁠Why This Image Exists

Dagu is an excellent lightweight workflow scheduler written in Go. It is ideal for:

• Cron-like job scheduling
• YAML-defined task dependencies
• Simple CI-style pipelines
• Small data workflows

However, the official Dagu image does not include Python.

If you frequently run Python scripts and find Apache Airflow too heavy for simple workflows, this image provides:

• A minimal scheduler
• A ready-to-use Python runtime
• No Airflow-level operational overhead

⁠Usage example

services:
  dagu:
    image: ieferrari/dagu_python:latest
    container_name: dagu_python
    restart: unless-stopped
    environment:
      - DAGU_PORT=8080
    volumes:
      - ./dags:/dagu/dags
      - ./scripts:/dagu/scripts
      # folder to persist venv, delete for a clean re-install 
      - ./dagu_venv:/dagu/venv
      # optionally add requirements.txt to install on first run
      - ./requirements.txt:/requirements/requirements.txt
    ports:
      - "8080:8080"

Create the folders with user permission

mkdir dags/ dagu_venv/ scripts/

and bring up the compose with

docker compose up -d

⁠Supported Tags

Tags follow this format:

<dagu-version>-python<python-version>

<dagu-version>-python<python-version>-pg (including psql for pg backups)

⁠Available Tags

• ieferrari/dagu_python:"1.30.2"-python"3.12-slim"
• ieferrari/dagu_python:"1.30.2"-python"3.13-slim"
• ieferrari/dagu_python:"1.30.2"-python"3.14-slim-trixie"
• ieferrari/dagu_python:"1.30.3"-python"3.12-slim"
• ieferrari/dagu_python:"1.30.3"-python"3.13-slim"
• ieferrari/dagu_python:"1.30.3"-python"3.14-slim-trixie"