Speckle Server Crashing on Startup in WSL2

Help Developers
1

I am currently working on setting up the development environment in WSL2 based on the instructions provided in the documentation. However, as I do not have prior experience in backend development, I am struggling with some issues. I sincerely appreciate your patience as I continue to seek guidance.

Objective

I am trying to set up the Speckle Server for local development in WSL2 following the official documentation.

Issue

When I follow the setup steps, I encounter the following issue:

[@speckle/server]: Node.js v18.20.7
[@speckle/server]: [server] [nodemon] app crashed - waiting for file changes before starting…

Environment details:

  • Yarn version: 4.5.0
  • Node.js version: v18.20.7

At this point, the process does not proceed any further, and I am unsure of what I might be misunderstanding or what needs to be fixed.

Example

If needed, I can provide additional logs or any relevant configuration files.

I would greatly appreciate any insights you can provide on what might be causing this issue and how I can resolve it. If you have any suggestions or steps I should follow, I would be very grateful for your assistance.

Best regards,
Baek

2

I followed Local Development Environment | Speckle Docs

3

Hi @inchan

I’ve just run through the instructions with a clean installation and I’m unfortunately unable to replicate the issue.

I assume you followed the below instructions?

  1. git clone git@github.com:specklesystems/speckle-server.git or, alternatively git clone https://github.com/specklesystems/speckle-server.git
  2. cd speckle-server
  3. corepack enable
  4. yarn
  5. yarn build
  6. yarn dev:docker:up
  7. cp packages/server/.env-example packages/server/.env
  8. cp packages/server/.env.test-example packages/server/.env.test
  9. cp packages/frontend-2/.env.example packages/frontend-2/.env
  10. cp packages/dui3/.env.example packages/dui3/.env
  11. yarn dev

Instead of the above step 11, could you please try:

  1. cd packages/server
  2. yarn dev

This will run the server component in isolation. Does the server start up properly? The server log should look like the following if successful:

Screenshot 2025-03-11 at 15.51.46
Screenshot 2025-03-11 at 15.51.461920×950 208 KB

1 Like
4

First of all, I sincerely appreciate your detailed and helpful response. I followed your instructions carefully, but as shown in the attached screenshot, I encountered an error with red text, and the process did not proceed any further.

I would like to ask for your advice on what additional topics I should study to resolve this issue and gain a better understanding of the process. Should I focus more on Docker, Nginx, or other backend-related knowledge?

image
image1430×965 27.3 KB

As our company is considering adopting the Speckle Server internally, I am exploring backend development to better support this initiative. Any guidance on where to start or which resources to refer to would be greatly appreciated.

Thank you again for your time and support.

5

It appears that the packages/shared package has not been built correctly. The yarn build step should be run from the directory at the root of the speckle-server repository (This is the directory containing yarn.lock, for example).

You can inspect that a packages/shared/dist directory has been created and populated with files after running the above command.

2 Likes
6

I ran the command inside the directory containing the yarn.lock file, and it worked successfully! I sincerely appreciate your help

Thanks you!!! :smiley:

1 Like