Skip to content

Dokku test suite

Dokku now has a full test suite to assist in quick iterating development. These tests include a linter using shellcheck, functional unit tests using the bats testing framework, and a deployment suite of example apps that use the most popular languages and frameworks.

Bats tests can be found here:


Example apps can be found here:


Executing tests locally

  • Setup dokku in a vagrant vm
  • Test setup and execution

$ vagrant ssh
$ sudo su -
$ cd ~/dokku
$ make ci-dependencies setup-deploy-tests
$ make test  # run the entire test suite (linter, bats tests, and app deployment tests)
$ make lint  # linter
$ make unit-tests  # bats tests
$ make deploy-tests  # app deployment tests
- Additionally you may run a specific app deployment tests with a target similar to:

make deploy-test-nodejs-express
- For a full list of test make targets check out in the root of the dokku repository.