Run on your computer

Set up your local computer or server as a runner

You can use your local computer or server as a runner if it runs one of the following operating systems:

  • macOS
  • Ubuntu 16.04 or later

Non-GPU-enabled workflows

Follow these steps to run on your machine’s CPUs.

Set up your computer as a runner: 1. Create a free account at with a username and password.

  1. Install Docker on the computer that you want to use as the runner. For this, we refer you to the following Docker installation guides: Install Docker on a Mac

Install Docker on Ubuntu

Or, use the installation script provided by

curl -fsSL -o
sudo sh

When installation is complete, verify that Docker is installed and running by entering docker info.

  1. Go to the Runners page on Dotscience Click Add your own runner. Select the Runner type, Storage space and Units that are most appropriate to your machine. Give the runner a name, and click Continue.

  2. Copy the code snippet from the Runners page. Your snippet will have the following form, but note that your TOKEN will vary:

docker pull && \
docker run --name dotscience-runner -d -e TOKEN=C2B3KKP5CTVUDTJW6FQJ6DIA5E3LXTIKVOSQPM4LEMFH2NFH6XYA==== \
    --restart always -v /var/run/docker.sock:/var/run/docker.sock \
    -v dotscience-task-spool:/spool \
  1. Verify that the Docker container that Dotscience needs is running. Run docker ps to see which containers are running. You should see that under CONTAINERS there is a container called dotscience-runner whose status is up.

GPU-enabled workflows

See the section on exposing GPU’s on your runner for more information on this.