Skip to content

Latest commit

 

History

History
43 lines (33 loc) · 1.82 KB

Installation.md

File metadata and controls

43 lines (33 loc) · 1.82 KB

Installation Instructions

1. Installing Git (Windows laptop only. Mac OS has Git already installed)

  • Navigate to: https://gitforwindows.org/
  • Download & install the latest version of Git for Windows.
  • This includes git as well as some tools like git bash

2. Installing Docker

3. Install your Favorite Terminal (You can skip this step if you already have one installed on your machine)

  • Git Bash for example, works well for this if you already installed it in step 1

4. Fork the GitHub repository and clone it locally.

  • In your favorite terminal, clone the repository
    git clone <GitHubRepo>
    
  • Navigate into the folder learning_labs

5. Create a Docker image of the BBIT Lab (This might take some time, so have a coffee :) )

  • First, ensure that docker is running and then in your favorite terminal, from the folder learning_labs, run the following command to build the docker image:
    docker build . --tag bbitlab
    

We can remove this step if we publish our image to DockerHub

6. Launch a docker container layer over the docker image of the lab

  • launch our container and mount the learning_labs folder as a volume to access the lab.

    docker run -p 8888:8888 -v <full path of the folder 'learning_labs'>:/app bbitlab
    
  • When the container fully launches, you should have a similar output. You should copy the URL (circled in red) and paste it into your favorite web browser to launch Jupyter Lab. alt text

If you have a similar page displaying in your browser, you are all set and ready to start working on the BBIT Lab. alt text

Thank you!!