Getting started

1. Requirements.

Digdag runs on Java. Make sure Java Runtime is installed.

Digdag version Java Runtime Version
>= 0.10.0 Java 8 or 11
< 0.10.0 Java 8

2. Downloading the latest version

Digdag is a single executable file. You can install the file to ~/bin using curl command as following:

$ curl -o ~/bin/digdag --create-dirs -L "https://dl.digdag.io/digdag-latest"
$ chmod +x ~/bin/digdag
$ echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc

Please reopen your terminal window or type following command so that the change of PATH takes effect.

$ source ~/.bashrc

If digdag --help command works, Digdag is installed successfully.

(Note: if you’re using zsh, modify your~/.zshrc file instead of ~/.bashrc).

On Windows?

On Windows, please open cmd.exe or PowerShell.exe and type following command exactly:

PowerShell -Command "& {[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::TLS12; mkdir -Force $env:USERPROFILE\bin; Invoke-WebRequest http://dl.digdag.io/digdag-latest.jar -OutFile $env:USERPROFILE\bin\digdag.bat}"

Above command downloads a file named digdag.bat to a folder named bin at your home folder (C:\Users\YOUR_NAME\bin).

Then, type following command so that cmd.exe or PowerShell.exe search digdag command from the bin folder:

setx PATH "%PATH%;%USERPROFILE%\bin"

Please reopen your command window. If digdag --help command shows usage message, Digdag is installed successfully.

Using packages?

Digdag has already been packaged for multiple platforms.

https://repology.org/badge/vertical-allrepos/digdag.svgPackaging status

curl did not work?

Some environments (ex: Ubuntu 16.04) may produce the following error:

curl: (77) error setting certificate verify locations:
  CAfile: /etc/pki/tls/certs/ca-bundle.crt
  CApath: none

Most likely, the SSL certificate file is in /etc/ssl/certs/ca-certificates.crt while curl expects it in /etc/pki/tls/certs/ca-bundle.crt. To fix this, run the folllowing:

$ sudo mkdir -p /etc/pki/tls/certs
$ sudo cp /etc/ssl/certs/ca-certificates.crt /etc/pki/tls/certs/ca-bundle.crt

Then, run Step 1 again.

Got error?

If you got an error such as ‘Unsupported major.minor version 52.0’, please download and install the latest Java SE Development Kit 8 (must be newer than 8u72).

3. Running sample workflow

digdag init <dir> command generates sample workflow for you:

$ digdag init mydag
$ cd mydag
$ digdag run mydag.dig

Did it work? Next step is adding tasks to digdag.dig file to automate your jobs.