Meshery Docs localhost not loading on Windows

Community
1

I’m trying to run the Meshery Docs repo locally on Windows to preview my docs/UI changes. I installed Hugo Extended and Go Programming Language successfully, and hugo server now completes the build without errors.

The build logs show:

  • modules downloaded successfully

  • site build completes in a few seconds

  • Hugo starts watching files

However:

  • I never get the usual Web Server is available at http://localhost:1313/ message

  • localhost:1313 and 127.0.0.1:1313 keep loading forever

  • changing ports also doesn’t help

I also tried:

  • hugo server --disableFastRender --renderToMemory --logLevel debug

Would appreciate guidance!

2

I don’t have a Windows machine to check this, but if you have Docker installed you can run the docs site locally with:

make docs-docker

That should get it running at http://localhost:1313/. Let me know how it goes!

3

Hi @Rishi_Raj
I managed to get Docker and Hugo running on Windows, and the meshery-docs container is staying up correctly on port 1313. I also confirmed that Hugo builds are progressing successfully.

However, hugo server still seems to get stuck before finishing the initial render, so localhost never fully loads and I never get the:

Web Server is available at http://localhost:1313/

message.

I tried a few things already:

  • --poll 700ms

  • disabling watch mode

  • disabling live reload

From the logs, it looks like the issue might be related to Docker volume mounts/file watching performance on Windows with a large Hugo repo.

Would switching to WSL2 Ubuntu be the better approach for working on Meshery Docs locally?

4

Just an update!
I used WSL2+Ubuntu and now its working.

Thanks!