Quick start

The quickest start is provided by containers or a cloud:

Containers

Docker quick start

docker run --rm -it -p 8888:8888 electronioncollider/escalate:latest

The command will start the jupyter lab server with example files. After running this command, open your browser

--rm flag Docker automatically cleans up the container and removes the file system when the container exits. By default (without –rm flag) a container’s file system persists even after the container exits. This makes debugging easier and you retain all your data. [More on the docker docs](https://docs.docker.com/engine/reference/run/#clean-up—rm). We use –rm flag for the sake of the tutorial repeatability. If you WORK with the container, you probably want to run without –rm.

-it flag enables interactive session. Without this flag ctrl+c will not work on Mac machines. In general -it is used to run e.g. bash session (see below)

More on Jupyter

Run without jupyter lab

You can start the docker without Jupyter Lab running:

docker run --rm -it -p 8888:8888 electronioncollider/escalate:latest bash

Later you can still run jupyter lab by

jlab    # It is Jupyter Lab here, not Jefferson

Software installed

What software is installed and where is it?

In Jupyter lab terminal

Changing and saving the contents

The files that you see in Jupyter Lab are stored in Git repository:

https://gitlab.com/eic/escalate/workspace

So when you do the change, that is important to save, you could make you branch or fork the repo. This

### Troubleshooting If docker gives an error like this: > Error starting userland proxy: listen tcp 0.0.0.0:8888: bind: address already in use.

It usually means, that the port 8888 is used by another application. To fix that try to change -p 8888:8888 flag to -p <something>:8888 e.g. -p 9999:8888. Put the same port in your browser: ` 127.0.0.1:9999/lab `