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
`