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.
- 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
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
.
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.
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
- Verify that the Docker container that Dotscience needs is running. Run
docker ps
to see which containers are running. You should see that underCONTAINERS
there is a container calleddotscience-runner
whose status isup
.
GPU-enabled workflows
See the section on exposing GPU’s on your runner for more information on this.