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:

tests/unit/*.bats

Example apps can be found here:

tests/apps/

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

# execute the entire test suite (linter, bats tests, and app deployment tests)
make test

# run linter & update vagrant dokku install from local git clone
make lint copyfiles

# execute all bats tests
make unit-tests

# execute all app deployment tests
make deploy-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 tests.mk in the root of the dokku repository.