Quick start guides

Leviathan allows for running tests on a device controlled by a worker. A worker is a component on which your tests actually runs. It can be both real hardware or virtualised environments. Leviathan is designed to work with multiple workers.

Clone the repository

• Clone this repository with git clone --recursive or
• Run git clone and then git submodule update --init --recursive to install submodules.

Prerequisites

• Install Docker, node and npm in your system. We recommend installing LTS versions from NVM.
• After installing Docker, do follow the post-installation steps listed to manage Docker as a non-root user.
• Download the balenaOS image you want to test on your DUT from balena.io/os.

Worker setup

Select which type of worker you want to use:

1. Testbot worker - Connect an actual device to your testbot and test on it
2. Autokit worker - Connect an actual device to your autokit and test on it
3. QEMU worker - Create a virtual device and run tests on that that.