host: <hostname for web UI address>                          # default value is 127.0.0.1 
port: <port number for web UI address>                       # default value is 8080
dags: <the location of DAG configuration files>              # default value is current working directory
command: <Absolute path to the dagu binary>                  # [optional] required if the dagu command not in $PATH
isBasicAuth: <true|false>                                    # [optional] basic auth config
basicAuthUsername: <username for basic auth of web UI>       # [optional] basic auth config
basicAuthPassword: <password for basic auth of web UI>       # [optional] basic auth config

logDir: <path-to-write-log>         # log directory to write standard output
histRetentionDays: 3                # history retention days
smtp:                               # [optional] mail server configurations to send notifications
  host: <smtp server host>
  port: <stmp server port>
errorMail:                          # [optional] mail configurations for error-level
  from: <from address>
  to: <to address>
  prefix: <prefix of mail subject>
infoMail:
  from: <from address>              # [optional] mail configurations for info-level
  to: <to address>
  prefix: <prefix of mail subject>

name: minimal configuration          # DAG name
steps:                               # steps inside the DAG
  - name: step 1                     # step name (should be unique within the file)
    description: step 1              # [optional] description of the step
    command: python main_1.py        # command and arguments
    dir: ${HOME}/dags/               # [optional] working directory
  - name: step 2
    description: step 2
    command: python main_2.py
    dir: ${HOME}/dags/
    depends:
      - step 1                       # [optional] dependant steps

name: all configuration              # DAG name
description: run a DAG               # DAG description
env:                                 # Environment variables
  LOG_DIR: ${HOME}/logs
  PATH: /usr/local/bin:${PATH}
logDir: ${LOG_DIR}                   # log directory to write standard output
histRetentionDays: 3                 # execution history retention days (not for log files)
delaySec: 1                          # interval seconds between steps
maxActiveRuns: 1                     # max parallel number of running step
params: param1 param2                # parameters can be refered by $1, $2 and so on.
preconditions:                       # precondisions for whether the DAG is allowed to run
  - condition: "`printf 1`"          # command or variables to evaluate
    expected: "1"                    # value to be expected to run the DAG
mailOn:
  failure: true                      # send a mail when the DAG failed
  success: true                      # send a mail when the DAG finished
handlerOn:                           # Handler on Success, Failure, Cancel, Exit
  success:                           # will be executed when the DAG succeed
    command: "echo succeed"
  failure:                           # will be executed when the DAG failed 
    command: "echo failed"
  cancel:                            # will be executed when the DAG canceled 
    command: "echo canceled"
  exit:                              # will be executed when the DAG exited
    command: "echo finished"
steps:
  - name: step 1                     # DAG name
    description: step 1              # DAG description
    dir: ${HOME}/logs                # working directory
    command: python main.py $1       # command and parameters
    mailOn:
      failure: true                  # send a mail when the step failed
      success: true                  # send a mail when the step finished
    continueOn:
      failed: true                   # continue to the next regardless the step failed or not
      skipped: true                  # continue to the next regardless the preconditions are met or not 
    retryPolicy:                     # retry policy for the step
      limit: 2                       # retry up to 2 times when the step failed
    preconditions:                   # precondisions for whether the step is allowed to run
      - condition: "`printf 1`"      # command or variables to evaluate
        expected: "1"                # value to be expected to run the step

name: example DAG
steps:
  - name: "1"
    command: echo hello world
  - name: "2"
    command: sleep 10
    depends:
      - "1"
  - name: "3"
    command: echo done!
    depends:
      - "2"

name: example DAG
env:
  LOG_DIR: ${HOME}/logs
logDir: ${LOG_DIR}
params: foo bar
steps:
  - name: "check precondition"
    command: echo start
    preconditions:
      - condition: "`echo $1`"
        expected: foo
  - name: "print foo"
    command: echo $1
    depends:
      - "check precondition"
  - name: "print bar"
    command: echo $2
    depends:
      - "print foo"
  - name: "failure and continue"
    command: "false"
    continueOn:
      failure: true
    depends:
      - "print bar"
  - name: "print done"
    command: echo done!
    depends:
      - "failure and continue"
handlerOn:
  exit:
    command: echo finished!
  success:
    command: echo success!
  failure:
    command: echo failed!
  cancel:
    command: echo canceled!

name: complex DAG
steps:
  - name: "Initialize"
    command: "sleep 2"
  - name: "Copy TAB_1"
    description: "Extract data from TAB_1 to TAB_2"
    command: "sleep 2"
    depends:
      - "Initialize"
  - name: "Update TAB_2"
    description: "Update TAB_2"
    command: "sleep 2"
    depends:
      - Copy TAB_1
  - name: Validate TAB_2
    command: "sleep 2"
    depends:
      - "Update TAB_2"
  - name: "Load TAB_3"
    description: "Read data from files"
    command: "sleep 2"
    depends:
      - Initialize
  - name: "Update TAB_3"
    command: "sleep 2"
    depends:
      - "Load TAB_3"
  - name: Merge
    command: "sleep 2"
    depends:
      - Update TAB_3
      - Validate TAB_2
      - Validate File
  - name: "Check File"
    command: "sleep 2"
  - name: "Copy File"
    command: "sleep 2"
    depends:
      - Check File
  - name: "Validate File"
    command: "sleep 2"
    depends:
      - Copy File
  - name: Calc Result
    command: "sleep 2"
    depends:
      - Merge
  - name: "Report"
    command: "sleep 2"
    depends:
      - Calc Result
  - name: Reconcile
    command: "sleep 2"
    depends:
      - Calc Result
  - name: "Cleaning"
    command: "sleep 2"
    depends:
      - Reconcile