# Web interface won't load

**URL:** <https://discourse.zynthian.org/t/web-interface-wont-load/11143>\
**Category:** Using Zynthian\
**Tags:** issue, oram\
**Created:** [February 27, 2025, 8:17am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143 "2025-02-27T08:17:19Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![3tree](https://discourse.zynthian.org/letter_avatar_proxy/v4/letter/3/e5b9ba/32.png) [@3tree](https://discourse.zynthian.org/u/3tree)\
**Post date:** [February 27, 2025, 8:17am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/1 "2025-02-27T08:17:19Z")

</div>

I’ve just rebuilt my custom zynthian from a new image downloaded yesterday. The web interface doesn’t load, or takes a long time. Are there any logs I can check to figure this out? And is there a way to restart it from command line? While waiting the Zynthian is accessible via VNC and I can navigate the Zynthian UI as normal.

---

<div class="post-metadata">

**Author:** ![wyleu](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/wyleu/32/514_2.png) [@wyleu](https://discourse.zynthian.org/u/wyleu)\
**Post date:** [February 27, 2025, 11:55am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/2 "2025-02-27T11:55:32Z")

</div>

Webconf offers the GUI log under Interfaces

that reports the sort of issues you might experience.

 ![20250227_11h54m18s_grim](https://discourse.zynthian.org/uploads/default/original/2X/4/4f1d2e5ed2b2b1aff25e998412cc8b9b3fc531ec.png)

---

<div class="post-metadata">

**Author:** ![rouxleandre](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/rouxleandre/32/13480_2.png) [@rouxleandre](https://discourse.zynthian.org/u/rouxleandre)\
**Post date:** [February 28, 2025, 7:30am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/3 "2025-02-28T07:30:51Z")

</div>

Hmm, could be unrelated, but I have this when my DNS acts up for some reason, never had this on the PI 3, but my PI 5 likes giving me DNS issues.

When it can’t reach the webconfig page or takes a long time, maybe check if you can actually reach it my name by pinging the device?

`ping zynthian` from a terminal

If it can’t find it, it likely can’t resolve it by name.

Workaround for me is to then switch to the IP address assigned by the router for both CLI SSH access and even the Web UI.

I have not had time to dig into why this happens.

@wyleu Do you know where the physical logs for that page is stored on the zynthian OS? Maybe that can help debug if @3tree cannot access the UI but can ssh into the system?

---

<div class="post-metadata">

**Author:** ![3tree](https://discourse.zynthian.org/letter_avatar_proxy/v4/letter/3/e5b9ba/32.png) [@3tree](https://discourse.zynthian.org/u/3tree)\
**Post date:** [February 28, 2025, 8:21am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/4 "2025-02-28T08:21:03Z")

</div>

yes that’s what I need - access to the logs on the device. I can vnc and access by terminal, it’s just the web ui doesn’t load, or is slow to do so. I typically use the ip (which is fixed) because zynthian.local wasn’t working and I hadn’t bothered to figure out why and forgotten about it. Or likely now it’s part of the same issue.

---

<div class="post-metadata">

**Author:** ![rouxleandre](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/rouxleandre/32/13480_2.png) [@rouxleandre](https://discourse.zynthian.org/u/rouxleandre)\
**Post date:** [February 28, 2025, 8:55am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/5 "2025-02-28T08:55:07Z")

</div>

Maybe start here, the Wiki suggests a few ways to access the system without the webconfig

[Command Line User Guide - ZynthianWiki](https://wiki.zynthian.org/index.php/Command_Line_User_Guide#Stopping.2FStarting_the_Zynthian_UI)

Also this topic:

[Log file and level - Development - Zynthian Discourse](https://discourse.zynthian.org/t/log-file-and-level/2458)

@3tree : This seems to be the one you are looking for `journalctl -u zynthian-webconf`

You can `tail` it if you want to see the last few lines output instead of scrolling through the whole log as well

---

<div class="post-metadata">

**Author:** ![3tree](https://discourse.zynthian.org/letter_avatar_proxy/v4/letter/3/e5b9ba/32.png) [@3tree](https://discourse.zynthian.org/u/3tree)\
**Post date:** [February 28, 2025, 9:43am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/6 "2025-02-28T09:43:50Z")

</div>

Here’s the log from the point where I re-opened the web ui and it took a couple of minutes or so to appear…

Feb 28 09:33:42 zynthian zynthian\_webconf.sh[841]: WARNING:tornado.access:404 GET /apple-touch-icon-precomposed.png (fe80::104f:e545:bb33:88ed) 0.49ms  
Feb 28 09:33:42 zynthian zynthian\_webconf.sh[841]: WARNING:tornado.access:404 GET /apple-touch-icon.png (fe80::104f:e545:bb33:88ed) 0.42ms  
Feb 28 09:33:42 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:200 GET /favicon.ico (fe80::104f:e545:bb33:88ed) 2.11ms  
Feb 28 09:33:42 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:200 GET /img/favicon\_196.png (fe80::104f:e545:bb33:88ed) 2.62ms  
Feb 28 09:33:42 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:200 GET /img/favicon.ico (fe80::104f:e545:bb33:88ed) 0.56ms  
Feb 28 09:33:42 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:200 GET /img/favicon\_180.png (fe80::104f:e545:bb33:88ed) 1.04ms  
Feb 28 09:33:44 zynthian zynthian\_webconf.sh[841]: DEBUG:root:Loaded engine config with timestamp: 1740608598.994155  
Feb 28 09:33:44 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:304 GET /zynterm (fe80::104f:e545:bb33:88ed) 49.45ms  
Feb 28 09:33:45 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:101 GET /zynterm\_ws (fe80::104f:e545:bb33:88ed) 0.52ms  
Feb 28 09:33:45 zynthian zynthian\_webconf.sh[841]: INFO:terminado.websocket:TermSocket.open: None  
Feb 28 09:33:45 zynthian zynthian\_webconf.sh[841]: INFO:terminado.websocket:TermSocket.open: Opened tty  
Feb 28 09:33:47 zynthian zynthian\_webconf.sh[841]: INFO:terminado.websocket:Websocket closed  
Feb 28 09:33:52 zynthian zynthian\_webconf.sh[841]: DEBUG:root:Loaded engine config with timestamp: 1740608598.994155  
Feb 28 09:35:46 zynthian zynthian\_webconf.sh[841]: DEBUG:root:Build info =\> Timestamp: 2024-10-02  
Feb 28 09:35:46 zynthian zynthian\_webconf.sh[841]: DEBUG:root:LV2 presets =\> 27  
Feb 28 09:35:46 zynthian zynthian\_webconf.sh[841]: DEBUG:root:Pianoteq presets =\> 0  
Feb 28 09:35:46 zynthian zynthian\_webconf.sh[841]: DEBUG:root:Puredata presets =\> 0  
Feb 28 09:35:46 zynthian zynthian\_webconf.sh[841]: DEBUG:root:ZynAddSubFX presets =\> 0  
Feb 28 09:35:46 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:200 GET / (fe80::104f:e545:bb33:88ed) 114858.88ms  
Feb 28 09:35:47 zynthian zynthian\_webconf.sh[841]: DEBUG:root:Loaded engine config with timestamp: 1740608598.994155  
Feb 28 09:35:47 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:200 GET /zynterm (fe80::104f:e545:bb33:88ed) 49.86ms  
Feb 28 09:35:47 zynthian zynthian\_webconf.sh[841]: DEBUG:root:Loaded engine config with timestamp: 1740608598.994155  
Feb 28 09:35:47 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:304 GET /zynterm (fe80::104f:e545:bb33:88ed) 101.75ms  
Feb 28 09:35:47 zynthian zynthian\_webconf.sh[841]: INFO:terminado.websocket:Websocket closed  
Feb 28 09:35:47 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:101 GET /zynterm\_ws (fe80::104f:e545:bb33:88ed) 0.51ms  
Feb 28 09:35:47 zynthian zynthian\_webconf.sh[841]: INFO:terminado.websocket:TermSocket.open: None  
Feb 28 09:35:47 zynthian zynthian\_webconf.sh[841]: INFO:terminado.websocket:TermSocket.open: Opened tty

---

<div class="post-metadata">

**Author:** ![rouxleandre](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/rouxleandre/32/13480_2.png) [@rouxleandre](https://discourse.zynthian.org/u/rouxleandre)\
**Post date:** [February 28, 2025, 9:54am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/7 "2025-02-28T09:54:31Z")

</div>

> [@3tree](#):
>
> Feb 28 09:35:46 zynthian zynthian\_webconf.sh[841]: INFO:tornado.access:200 GET / (fe80::104f:e545:bb33:88ed) 114858.88ms

Seems like a fairly long time for this to return 200, could be the culprit (or just a symptom of an underlaying issue) if the loading on this call is supposed to return faster

---

<div class="post-metadata">

**Author:** ![3tree](https://discourse.zynthian.org/letter_avatar_proxy/v4/letter/3/e5b9ba/32.png) [@3tree](https://discourse.zynthian.org/u/3tree)\
**Post date:** [February 28, 2025, 9:56am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/8 "2025-02-28T09:56:02Z")

</div>

anything more I can do, or explore, or are we dependent on insights from zynthian experts?!

---

<div class="post-metadata">

**Author:** ![rouxleandre](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/rouxleandre/32/13480_2.png) [@rouxleandre](https://discourse.zynthian.org/u/rouxleandre)\
**Post date:** [February 28, 2025, 9:59am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/9 "2025-02-28T09:59:40Z")

</div>

Think we are going to have to ask for some insights from the experts.

@wyleu Anything you think we can look into?

---

<div class="post-metadata">

**Author:** ![rouxleandre](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/rouxleandre/32/13480_2.png) [@rouxleandre](https://discourse.zynthian.org/u/rouxleandre)\
**Post date:** [February 28, 2025, 10:14am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/10 "2025-02-28T10:14:57Z")

</div>

Also, one more thing to maybe help debug it…

What are your hardware specs on your custom build?

Also, if you turn off VNC, does the problem go away? (Shot in the dark)

---

<div class="post-metadata">

**Author:** ![3tree](https://discourse.zynthian.org/letter_avatar_proxy/v4/letter/3/e5b9ba/32.png) [@3tree](https://discourse.zynthian.org/u/3tree)\
**Post date:** [February 28, 2025, 11:13am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/11 "2025-02-28T11:13:09Z")

</div>

It’s an 8gb Raspberry Pi 5 Model B Rev 1.0. I tried turning off VNC, no change. I recall this happened a while ago but I dropped it when I didn’t get anywhere. Anyway, an odd workaround - if I disconnect the power (via the pin header) to the touch screen, it fixes it. So not a practical fix, but might point to a solution?

---

<div class="post-metadata">

**Author:** ![wyleu](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/wyleu/32/514_2.png) [@wyleu](https://discourse.zynthian.org/u/wyleu)\
**Post date:** [February 28, 2025, 12:47pm UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/12 "2025-02-28T12:47:41Z")

</div>

> [@rouxleandre](#):
>
> @wyleu Do you know where the physical logs for that page is stored on the zynthian OS? Maybe that can help debug if @3tree cannot access the UI but can ssh into the system?

> journalctl -fu zynthian

will show you zynthian events.

> journalctl -fu zynthian-webconf

Does similarly for the separate webconf instance.

journalctl has many many options for log analysis.  
The most effective way of isolating a webconf problem, is to shut dwon the systemd zynthian-webconf service…

> systemctl stop zynthian-webconf

This will stop the auto restart mechansism. Then we want to run the webconf instance from the command line so…

> cd /zynthian/zynthian-webconf/

Then start the shell script…

> . zynthian\_webconf.sh

Make sure to add the . and the space…

You should see the error that holding it all up…

---

<div class="post-metadata">

**Author:** ![3tree](https://discourse.zynthian.org/letter_avatar_proxy/v4/letter/3/e5b9ba/32.png) [@3tree](https://discourse.zynthian.org/u/3tree)\
**Post date:** [February 28, 2025, 1:52pm UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/13 "2025-02-28T13:52:43Z")

</div>

Thanks for the info, here’s the response to running the shell script…

root@zynthian:/zynthian/zynthian-webconf# . zynthian\_webconf.sh  
Traceback (most recent call last):  
File “/zynthian/zynthian-webconf/./zynthian\_webconf.py”, line 32, in   
import tornado.web  
ModuleNotFoundError: No module named ‘tornado’  
root@zynthian:/zynthian/zynthian-webconf#

---

<div class="post-metadata">

**Author:** ![wyleu](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/wyleu/32/514_2.png) [@wyleu](https://discourse.zynthian.org/u/wyleu)\
**Post date:** [February 28, 2025, 1:55pm UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/14 "2025-02-28T13:55:31Z")

</div>

I would expect that to be running within a virtual window …

Do you have (venv) at the start of the line?

Tornado is a core component so should be there, but it you are running outside of the virtual environment that zynthian uses then you will not find tornado…

It sounds like you aren’t running within a python virtual environment.

---

<div class="post-metadata">

**Author:** ![wyleu](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/wyleu/32/514_2.png) [@wyleu](https://discourse.zynthian.org/u/wyleu)\
**Post date:** [February 28, 2025, 2:27pm UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/16 "2025-02-28T14:27:01Z")

</div>

The zynthian is predominantly written in the python language, and python allows you to load modules that add functionality. tornado, is one among many. It is a web framework that operates a web server that zynthian use to display its web based configuration page.

There is a problem when running multiple modules, because there are subtle differences between versions of modules that can conflict.

To address this python allows the construction of code environments that offer specific complete versions of modules. A so called virtual environment where python gets to see a carefully prescribed list of specified modules of known version.

It’s a good thing.

You can tell that the virtual environment is running when you log in via ssh is the prompt  
(venv) root@zynthian-rack6:~#

IF you aren’t running the virtual environment, for some reason, than that would behave that way. But it could be a red herring.

---

<div class="post-metadata">

**Author:** ![3tree](https://discourse.zynthian.org/letter_avatar_proxy/v4/letter/3/e5b9ba/32.png) [@3tree](https://discourse.zynthian.org/u/3tree)\
**Post date:** [February 28, 2025, 2:30pm UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/17 "2025-02-28T14:30:41Z")

</div>

ah ok, no there is no (venv) prefix when I ssh to the terminal session.

It’s definitely impeded by the touch screen though. On reboot just now I opened the web ui and waited whilst it loaded, after a minute whilst waiting I unplugged the screen and the second I did the ui popped up.

---

<div class="post-metadata">

**Author:** ![3tree](https://discourse.zynthian.org/letter_avatar_proxy/v4/letter/3/e5b9ba/32.png) [@3tree](https://discourse.zynthian.org/u/3tree)\
**Post date:** [March 1, 2025, 6:44am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/18 "2025-03-01T06:44:10Z")

</div>

Is there anything else in can check? And @wyleu how do I run it inside a virtual window?

---

<div class="post-metadata">

**Author:** ![riban](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/riban/32/2331_2.png) [@riban](https://discourse.zynthian.org/u/riban)\
**Post date:** [March 1, 2025, 8:28am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/19 "2025-03-01T08:28:35Z")

</div>

What version of zynthian are you running? Did you install oram from a downloaded image? (Lack of venv is very suspisious.) Is it any part of webconf that is slow or just certain pages?

---

<div class="post-metadata">

**Author:** ![3tree](https://discourse.zynthian.org/letter_avatar_proxy/v4/letter/3/e5b9ba/32.png) [@3tree](https://discourse.zynthian.org/u/3tree)\
**Post date:** [March 1, 2025, 8:55am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/20 "2025-03-01T08:55:51Z")

</div>

Here’s the s/w details from webconf…

zyncoder: [oram-2502.1 (092fb26)](https://github.com/zynthian/zyncoder/commit/092fb26e2eb118177b08256afa6fddc96daee83c)  
zynthian-ui: [oram-2502.1 (e48c01b)](https://github.com/zynthian/zynthian-ui/commit/e48c01b1401e8e48b20f8189c9b01678d0adb58e)  
zynthian-sys: [oram-2502.1 (a0a0ac5)](https://github.com/zynthian/zynthian-sys/commit/a0a0ac5d49d37b332b50aed77f49451a92c07d28)  
zynthian-data: [oram-2502.1 (10f663b)](https://github.com/zynthian/zynthian-data/commit/10f663bdc65917ae6390181dc80884884cf0bea5)  
zynthian-webconf: [oram-2502.1 (9e5e062)](https://github.com/zynthian/zynthian-webconf/commit/9e5e0629084b73f1828109a386d6ce5a470e0034)

I did a fresh install this week, downloading the image, installing via the raspberry pi imager because etcher kept crashing at 100%.

Since the above, I’ve left the touchscreen unplugged and webconf now loads and runs v quickly. With the screen connected, it’s slow to load but then responds ok once loaded.

I’m not clear on venv - when I connect to the command line as root, should I just see (venv) at the start of the prompt, by default, or is there a way you connect to access that?

---

<div class="post-metadata">

**Author:** ![wyleu](https://discourse.zynthian.org/user_avatar/discourse.zynthian.org/wyleu/32/514_2.png) [@wyleu](https://discourse.zynthian.org/u/wyleu)\
**Post date:** [March 1, 2025, 9:01am UTC](https://discourse.zynthian.org/t/web-interface-wont-load/11143/21 "2025-03-01T09:01:07Z")

</div>

> [@3tree](#):
>
> should I just see (venv) at the start of the prompt, by default

Yes. It should look after itself, which is why I was, keen to find out if you were running a venv. We could just be confused, but it would explain your ability to not load tornado in this instance, but this could distract from the real problem.

[Next page](https://discourse.zynthian.org/t/web-interface-wont-load/11143.md?page=2)