You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/setup.md
+15-10Lines changed: 15 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -101,11 +101,16 @@ Occasionally, when you first run Docker on Windows, you will encounter an error
101
101
102
102
**Running JupyterLab** Run Docker Desktop. Once it is running, you need to download and run the
103
103
Docker *image* that we have made available for the worksheets (an *image* is like a "snapshot" of a
104
-
computer with all the right packages pre-installed). In the search bar, enter `ubcdsci/py-dsci-100`, as this is
105
-
the name of the image. You will be presented
106
-
with a few options ({numref}`docker-desktop-search`). In the "Tag" drop down menu, click
107
-
the tag `20230720213731d08401` to select the correct version of the image. Then click
108
-
the "Pull" button to download the image.
104
+
computer with all the right packages pre-installed). You only need to do this step one time; the image will remain
105
+
the next time you run Docker Desktop.
106
+
In the Docker Desktop search bar, enter `ubcdsci/py-dsci-100`, as this is
107
+
the name of the image. You will see the `ubcdsci/py-dsci-100` image in the list ({numref}`docker-desktop-search`),
108
+
and "latest" in the Tag drop down menu. We need to change "latest" to the right image version before proceeding.
109
+
To find the right tag, open
110
+
the [`Dockerfile` in the worksheets repository](https://raw.githubusercontent.com/UBC-DSCI/data-science-a-first-intro-python-worksheets/main/Dockerfile),
111
+
and look for the line `FROM ubcdsci/py-dsci-100:` followed by the tag consisting of a sequence of numbers and letters.
112
+
Back in Docker Desktop, in the "Tag" drop down menu, click that tag to select the correct image version. Then click
113
+
the "Pull" button to download the image.
109
114
110
115
```{figure} img/setup/docker-1.png
111
116
---
@@ -127,8 +132,6 @@ name: docker-desktop-images
127
132
The Docker Desktop images tab.
128
133
```
129
134
130
-
131
-
132
135
To start up a *container* using that image, click the play button beside the
133
136
image. This will open the run configuration menu ({numref}`docker-desktop-runconfig`).
134
137
Expand the "Optional settings" drop down menu. In the "Host port" textbox, enter
**Running JupyterLab** In the terminal, navigate to the directory where you want to run JupyterLab, and run
200
-
the following command.
202
+
**Running JupyterLab** First, open the [`Dockerfile` in the worksheets repository](https://raw.githubusercontent.com/UBC-DSCI/data-science-a-first-intro-python-worksheets/main/Dockerfile),
203
+
and look for the line `FROM ubcdsci/py-dsci-100:` followed by a tag consisting of a sequence of numbers and letters.
204
+
Then in the terminal, navigate to the directory where you want to run JupyterLab, and run
205
+
the following command, replacing `TAG` with the *tag* you found earlier.
201
206
```
202
-
docker run --rm -v $(pwd):/home/jovyan/work -p 8888:8888 ubcdsci/py-dsci-100:20230720213731d08401 jupyter lab
207
+
docker run --rm -v $(pwd):/home/jovyan/work -p 8888:8888 ubcdsci/py-dsci-100:TAG jupyter lab
203
208
```
204
209
The terminal will then print some text as the Docker container starts. Once the text stops scrolling, find the
205
210
URL in your terminal that starts with `http://127.0.0.1:8888` (highlighted by the
0 commit comments