# Unable to use JupyterLab properly

**URL:** <https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286>\
**Category:** Support\
**Created:** [April 7, 2025, 3:47pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286 "2025-04-07T15:47:03Z")\
**Posts on this page:** 18\
**Page:** 1

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 7, 2025, 3:47pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/1 "2025-04-07T15:47:03Z")

</div>

Dear all,

My RFSoC-PYNQ version is 2.7.  
Me and @marioruiz have just resolved the issue with inability to connect to the board:

> [@Cannot connect to PYNQ on ZCU111](https://discuss.pynq.io/t/cannot-connect-to-pynq-on-zcu111/8272):
>
> Dear all, I downloaded the archive for ZCU111 from [PYNQ supported boards and PYNQ pre-built images | PYNQ](https://www.pynq.io/boards) which contained an image file called zcu111\_v3.0.1.img. Using balenaEtcher I flashed the image to a (10-class 16gb) SD card FAT32 (32 kilobytes allocation size) formatted form built-in Windows file explorer. I plugged the SD card into the ZCU111 board, set the SW6 switches to boot from SD card (up down down down). The power, micro-USB and Ethernet cable are connected to the computer. …

And now I am facing different issues:

1. When I use a command “ **pynq get\_noteboooks** ” through either PuTTy or JupyterLab terminal it gives the output: **WARNING: No notebooks available, nothing can be delivered**.

2. I tried to go through the 2nd notebook from the folder **getting\_started on RFSoC-PYNQ,** which is called “ **2\_python\_environment.ipynb** ”, and figured out, that the function **pynq.allocate() does not work** for me either

3. Also, on this webpage - [Loading an Overlay — Python productivity for Zynq (Pynq)](https://pynq.readthedocs.io/en/latest/pynq_overlays/loading_an_overlay.html) - it is said that I can use the following code in python on the pynq:

I think these problems are all somehow connected. Could you please help me to solve the problem?

---

<div class="post-metadata">

**Author:** ![marioruiz](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.pynq.io/marioruiz/32/2177_2.png) [@marioruiz](https://discuss.pynq.io/u/marioruiz)\
**Post date:** [April 7, 2025, 4:26pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/2 "2025-04-07T16:26:07Z")

</div>

Hi @CrusadOr,

Can you please let us know what instructions are you following?

Also, can you please confirm which PYNQ SD card image you are using? In one post you said 3.0.1, but here you are saying 2.7.

Mario

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 8, 2025, 11:45am UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/3 "2025-04-08T11:45:09Z")

</div>

Dear @marioruiz,

Now I decided to try to stick to **2.7** , that is correct.

These are the steps I followed:

1. I want to go through **the book** available at [https://www.rfsocbook.com/](https://www.rfsocbook.com/), in which some of the Notebooks require RFSoC-PYNQ on the board.

2. On the 33rd page of RDF file (book) there is a link to [GitHub - strath-sdr/RFSoC-Book: Companion Jupyter Notebooks for the RFSoC-Book.](https://github.com/strath-sdr/RFSoC-Book) which says in the section **"RFSoC Setup**" that I **need a version 2.7 or higher** to use these notebooks.

3. I used the attached in the first line of this section link to [Releases · Xilinx/PYNQ · GitHub](https://github.com/Xilinx/PYNQ/releases) where I found **[ZCU111 v2.7.0 SDCard image]** in “Austin release” section.

4. After I launched the board with PYNQ, I managed to connect to JupyterNotebooks and found “ **Welcome to Pynq.ipynb** ” notebook  
 ![image](https://us1.discourse-cdn.com/flex019/uploads/pynq1/original/2X/3/315de9b763f3094230ced04102aae50da568f346.png)

5. There I found a link to PYNQ documentation: [PYNQ Introduction — Python productivity for Zynq (Pynq)](https://pynq.readthedocs.io/en/latest/)

6. Where in the section “ **PYNQ command line interface** ” ([PYNQ Command Line Interface — Python productivity for Zynq (Pynq)](https://pynq.readthedocs.io/en/latest/pynq_cli.html)) was a command:

Same with overlay module - I found it in the “ **Loading an Overlay** ” section of this documentation.

As I understand this are basic functions of PYNQ that are not working for some reason and I do not know how to get the notebooks for the book.

---

<div class="post-metadata">

**Author:** ![marioruiz](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.pynq.io/marioruiz/32/2177_2.png) [@marioruiz](https://discuss.pynq.io/u/marioruiz)\
**Post date:** [April 8, 2025, 2:10pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/4 "2025-04-08T14:10:23Z")

</div>

Hi @CrusadOr,

Did you follow the steps in the repo to install the designs?

> **[GitHub - strath-sdr/RFSoC-Book: Companion Jupyter Notebooks for the RFSoC-Book.](https://github.com/strath-sdr/RFSoC-Book?tab=readme-ov-file#notebook-installation)**
>
> Companion Jupyter Notebooks for the RFSoC-Book.

Mario

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 9, 2025, 1:12pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/5 "2025-04-09T13:12:15Z")

</div>

I think I missed this part. Thank you!

I will text back tomorrow as soon as I figure out whether this works!

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 10, 2025, 9:01am UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/6 "2025-04-10T09:01:17Z")

</div>

Dear @marioruiz , I followed the Notebook installation section until this step:  
Execute a command in the board JupyterLab Terminal:  
`pip install https://github.com/strath-sdr/RFSoC-Book/archive/v1.1.0.tar.gz`  
Here I get the following message:

```auto
> Collecting https://github.com/strath-sdr/RFSoC-Book/archive/v1.1.0.tar.gz
> WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<pip._vendor.urllib3.connection.HTTPSConnection object at 0xffff9f85f520>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution')': /strath-sdr/RFSoC-Book/archive/v1.1.0.tar.gz
> ...
> WARNING: Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<pip._vendor.urllib3.connection.HTTPSConnection object at 0xffff9f85fc40>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution')': /strath-sdr/RFSoC-Book/archive/v1.1.0.tar.gz
> ERROR: Could not install packages due to an OSError: HTTPSConnectionPool(host='github.com', port=443): Max retries exceeded with url: /strath-sdr/RFSoC-Book/archive/v1.1.0.tar.gz (Caused by NewConnectionError('<pip._vendor.urllib3.connection.HTTPSConnection object at 0xffff9f85fdf0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))
> 
> WARNING: You are using pip version 21.2.1; however, version 21.3.1 is available.
> You should consider upgrading via the '/usr/local/share/pynq-venv/bin/python3 -m pip install --upgrade pip' command.

```

I also tried another link: (because this is the actual location of the archive I found using my PC)

`pip install https://github.com/strath-sdr/RFSoC-Book/archive/refs/tags/v1.1.0.tar.gz`

But this does not work either from the board JupyterLab Terminal.  
It is possible to install the notebooks form cmd on PC.

Seems like the board cannot connect to github?

---

<div class="post-metadata">

**Author:** ![marioruiz](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.pynq.io/marioruiz/32/2177_2.png) [@marioruiz](https://discuss.pynq.io/u/marioruiz)\
**Post date:** [April 10, 2025, 9:55am UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/7 "2025-04-10T09:55:48Z")

</div>

Hi @CrusadOr,

Is the board able to access the Internet? It may be possible to install without access to internet, but it will take a bit of effort.

Mario

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 10, 2025, 11:02am UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/8 "2025-04-10T11:02:42Z")

</div>

I do not know whether it is able to access internet or not. Seems like it is not from all the above.

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 11, 2025, 2:51pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/9 "2025-04-11T14:51:38Z")

</div>

Dear @marioruiz ,

How should it be connected to the internet if this is needed? The Ethernet cable is plugged directly into the PC, and I am not sure about software part of RFSoC-PYNQ image

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 11, 2025, 3:02pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/10 "2025-04-11T15:02:42Z")

</div>

Also I figured that in **cmd** a command “ **ping 192.168.2.99** ” works with **0% loss** , but **in**  **serial terminal with session with PYNQ on the board** the command “ **ping 192.168.2.2** ” (_which is IP of my PC for the board_) the waiting time is **infinite** and after interruption it **gives 100% loss** , which might be an error, but I am not sure

---

<div class="post-metadata">

**Author:** ![marioruiz](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.pynq.io/marioruiz/32/2177_2.png) [@marioruiz](https://discuss.pynq.io/u/marioruiz)\
**Post date:** [April 11, 2025, 4:11pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/11 "2025-04-11T16:11:49Z")

</div>

You will have to connect the board to a router or bridge the Internet from your machine to the board. You can also try with an USB dongle and connect to WiFi, you may not want to do this while capturing the spectrum.

Mario

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 14, 2025, 10:43am UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/12 "2025-04-14T10:43:04Z")

</div>

Dear @marioruiz , thank you for your suggestion.

And it seems like it was right: after I connected the board to my router instead of the PC with Ethernet cable, it was able to ping [google.com](http://google.com) and, consequently, it managed to connect to github and almost started downloading the notebooks.

But there is still an issue. When I run the command from the guide:

`pip install https://github.com/strath-sdr/RFSoC-Book/archive/v1.1.0.tar.gz`

I get the following output:

> WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘ReadTimeoutError(“HTTPSConnectionPool(host=‘[github.com](http://github.com)’, port=443): Read timed out. (read timeout=15)”)’: /strath-sdr/RFSoC-Book/archive/refs/tags/v1.1.0.tar.gz
> 
> WARNING: Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by ‘ReadTimeoutError(“HTTPSConnectionPool(host=‘[github.com](http://github.com)’, port=443): Read timed out. (read timeout=15)”)’: /strath-sdr/RFSoC-Book/archive/refs/tags/v1.1.0.tar.gz  
> ERROR: Could not install packages due to an OSError: HTTPSConnectionPool(host=‘[github.com](http://github.com)’, port=443): Max retries exceeded with url: /strath-sdr/RFSoC-Book/archive/refs/tags/v1.1.0.tar.gz (Caused by ReadTimeoutError(“HTTPSConnectionPool(host=‘[github.com](http://github.com)’, port=443): Read timed out. (read timeout=15)”))

Now it seems like the problem is that the notebooks do not download fast enough, but I am not sure. Even with extended timeout time I get the same warning:  
`pip install --default-timeout=100 https://github.com/strath-sdr/RFSoC-Book/archive/v1.1.0.tar.gz`

I would be glad if you helped me with this last, as how I hope, step.  
Thank you again!

---

<div class="post-metadata">

**Author:** ![marioruiz](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.pynq.io/marioruiz/32/2177_2.png) [@marioruiz](https://discuss.pynq.io/u/marioruiz)\
**Post date:** [April 14, 2025, 5:36pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/13 "2025-04-14T17:36:21Z")

</div>

Are you able to ping [github.com](http://github.com)? You could try to download the assets and install them manually.

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 15, 2025, 9:22am UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/14 "2025-04-15T09:22:56Z")

</div>

I cannot even download the corresponding archive, even though I am able to detect github and connect to it:

 ![image](https://us1.discourse-cdn.com/flex019/uploads/pynq1/original/2X/d/d1e2e7f02343a3937a227124dec12b6df04f79ed.png)

---

<div class="post-metadata">

**Author:** ![marioruiz](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.pynq.io/marioruiz/32/2177_2.png) [@marioruiz](https://discuss.pynq.io/u/marioruiz)\
**Post date:** [April 15, 2025, 9:38am UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/15 "2025-04-15T09:38:43Z")

</div>

Hi @CrusadOr,

Is it possible that a firewall is blocking the download?

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 15, 2025, 12:55pm UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/16 "2025-04-15T12:55:09Z")

</div>

That is possible, because this is not a private network  
Still it is possible to download the archive from PC, so I think this is not the case and the problem is on the board side

---

<div class="post-metadata">

**Author:** ![CrusadOr](https://avatars.discourse-cdn.com/v4/letter/c/d6d6ee/32.png) [@CrusadOr](https://discuss.pynq.io/u/CrusadOr)\
**Post date:** [April 18, 2025, 9:46am UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/17 "2025-04-18T09:46:39Z")

</div>

I think in any case by now this problem is already out of the scope of forum discussion and this question particularly, so I will close the topic and try to solve the problem with the admin of the network. I wish you all the best and thank you for your answers, you helped me a lot!

---

<div class="post-metadata">

**Author:** ![system](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.pynq.io/system/32/2_2.png) [@system](https://discuss.pynq.io/u/system)\
**Post date:** [April 21, 2025, 9:47am UTC](https://discuss.pynq.io/t/unable-to-use-jupyterlab-properly/8286/18 "2025-04-21T09:47:05Z")

</div>

This topic was automatically closed 3 days after the last reply. New replies are no longer allowed.
