Set Up Runners

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 cloud.dotscience.com 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 docker.com

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

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

  1. Go to the Runners page on Dotscience https://cloud.dotscience.com/runners/. 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 quay.io/dotmesh/dotscience-runner:latest && \
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 \
    quay.io/dotmesh/dotscience-runner:latest
  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.