Set Up

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. Register 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

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 a runner. Give your runner a name and, optionlly, a description to remind you which machine the runner is.

  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

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