Skip to content

Commit 50a984c

Browse files
remove version specific material from setup
1 parent d64dfe2 commit 50a984c

File tree

1 file changed

+15
-10
lines changed

1 file changed

+15
-10
lines changed

source/setup.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -101,11 +101,16 @@ Occasionally, when you first run Docker on Windows, you will encounter an error
101101

102102
**Running JupyterLab** Run Docker Desktop. Once it is running, you need to download and run the
103103
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.
109114

110115
```{figure} img/setup/docker-1.png
111116
---
@@ -127,8 +132,6 @@ name: docker-desktop-images
127132
The Docker Desktop images tab.
128133
```
129134

130-
131-
132135
To start up a *container* using that image, click the play button beside the
133136
image. This will open the run configuration menu ({numref}`docker-desktop-runconfig`).
134137
Expand the "Optional settings" drop down menu. In the "Host port" textbox, enter
@@ -196,10 +199,12 @@ sudo chmod u+x get-docker.sh
196199
sudo sh get-docker.sh
197200
```
198201

199-
**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.
201206
```
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
203208
```
204209
The terminal will then print some text as the Docker container starts. Once the text stops scrolling, find the
205210
URL in your terminal that starts with `http://127.0.0.1:8888` (highlighted by the

0 commit comments

Comments
 (0)