Unable to run the dev environment
Hi all, I'm struggling since yesterday to run the dev environment.
I'm using ArchLinux with nodejs version 23.11.1. I've installed the node modules with pnpm install, without error messages.
It seems that node can't reach Redis, but I have a working Redis installation on my laptop (I've checked it with redis6-benchmark) :
@homarr/nextjs:dev: [ioredis] Unhandled error event: Error: connect ETIMEDOUT
@homarr/nextjs:dev: at Socket.eval (webpack-internal:///(rsc)/../../node_modules/ioredis/built/Redis.js:170:41)
@homarr/nextjs:dev: at Object.onceWrapper (node:events:621:28)
@homarr/nextjs:dev: at Socket.emit (node:events:507:28)
@homarr/nextjs:dev: at Socket._onTimeout (node:net:609:8)
@homarr/nextjs:dev: at listOnTimeout (node:internal/timers:608:17)
@homarr/nextjs:dev: at process.processTimers (node:internal/timers:543:7)
Solution:Jump to solution
I think I may have a problem with my environment, because even when using the main branch, I have the same error.
32 Replies
Thank you for submitting a support request.
Depending on the volume of requests, our team should get in contact with you shortly.
⚠️ Please include the following details in your post or we may reject your request without further comment: - Log (See https://homarr.dev/docs/community/faq#how-do-i-open-the-console--log) - Operating system (Unraid, TrueNAS, Ubuntu, ...) - Exact Homarr version (eg. 0.15.0, not latest) - Configuration (eg. docker-compose, screenshot or similar. Use ``your-text`` to format) - Other relevant information (eg. your devices, your browser, ...)
Frequently Asked Questions | Homarr documentation
Can I install Homarr on a Raspberry Pi?
Have you started the docker compose?
It is required. Ensure that it doesn't conflict with your host redis instance
As I've created the redis instance only for Homarr, I've stopped it and ran the docker compose
But still an error @homarr/nextjs:dev: ○ Compiling /_not-found ...
@homarr/nextjs:dev: ✓ Compiled /_not-found in 1583ms (643 modules)
@homarr/nextjs:dev: ⚠ Fast Refresh had to perform a full reload due to a runtime error.
@homarr/nextjs:dev: GET /_next/static/webpack/c424cceabfad1a50.webpack.hot-update.json 404 in 1932ms
@homarr/nextjs:dev: ○ Compiling /middleware ...
@homarr/nextjs:dev: ⚠ Fast Refresh had to perform a full reload due to a runtime error.
@homarr/nextjs:dev: GET /_next/static/webpack/c424cceabfad1a50.webpack.hot-update.json 404 in 99ms
@homarr/nextjs:dev: ✓ Compiled /middleware in 1736ms (424 modules)
@homarr/nextjs:dev: ⚠ Fast Refresh had to perform a full reload due to a runtime error.
@homarr/nextjs:dev: GET /_next/static/webpack/c424cceabfad1a50.webpack.hot-update.json 404 in 82ms
@homarr/nextjs:dev: ⚠ Fast Refresh had to perform a full reload due to a runtime error.
@homarr/nextjs:dev: ⨯ [Error [TRPCClientError]: fetch failed]
@homarr/nextjs:dev: ⨯ [Error [TRPCClientError]: fetch failed]
@homarr/nextjs:dev: ⨯ [Error [TRPCClientError]: fetch failed]
@homarr/nextjs:dev: ○ Compiling /_error ...
@homarr/nextjs:dev: ✓ Compiled /_error in 1292ms (976 modules)
@homarr/nextjs:dev: ⨯ [Error [TRPCClientError]: fetch failed]
@homarr/nextjs:dev: GET / 404 in 7ms
@homarr/nextjs:dev: ⨯ [Error [TRPCClientError]: fetch failed]
@homarr/nextjs:dev: GET / 404 in 3ms
But as it's a dev env, I'm using sqlite as database
Did you copy the env file, like in the docs?
And how are you trying to start Homarr?
I've created a .env file after copying the .env.sample and changing the path for sqlite db and adding a secret
I start Homarr with pnpm run dev
Ok, is this the full log you sent? It is suspiciously short. And just to confirm, you cloned from homarr-labs/homarr ?
I forked and cloned the fork.
I'll send you the full log
Yes, but the fork is from homarr-labs/homarr, correct?
yes, the dev branch
Can you post as a pastebin?
I cannot open files on mobile
Pastebin
➜ homarr git:(dev) ✗ pnpm dev > homarr@1.22.0 dev /home/oup...
Pastebin.com is the number one paste tool since 2002. Pastebin is a website where you can store text online for a set period of time.
For me it seems like it can not connect to redis on the default port, have you changed that in the compose file?
No I didn't
Redis benchmark works well, so I don't think that's that
I'm still digging to make my dev environnement work, and I found this in the logs : @homarr/nextjs:dev: ○ Compiling /api/trpc/[trpc] ...
@homarr/tasks:dev: 2025-06-04T08:16:02.841Z info: Updating icons in database...
@homarr/nextjs:dev: ⚠ ../../node_modules/ssh2/lib/protocol/crypto.js
@homarr/nextjs:dev: Module not found: Can't resolve './crypto/build/Release/sshcrypto.node' in '/home/oupsman/WebstormProjects/homarr/node_modules/ssh2/lib/protocol'
@homarr/nextjs:dev:
@homarr/nextjs:dev: Import trace for requested module:
@homarr/nextjs:dev: ../../node_modules/ssh2/lib/protocol/crypto.js
@homarr/nextjs:dev: ../../node_modules/ssh2/lib/protocol/keyParser.js
@homarr/nextjs:dev: ../../node_modules/ssh2/lib/index.js
@homarr/nextjs:dev: ../../node_modules/docker-modem/lib/ssh.js
@homarr/nextjs:dev: ../../node_modules/docker-modem/lib/modem.js
@homarr/nextjs:dev: ../../node_modules/dockerode/lib/docker.js
@homarr/nextjs:dev: ../../packages/docker/src/singleton.ts
@homarr/nextjs:dev: ../../packages/docker/src/index.ts
@homarr/nextjs:dev: ../../packages/request-handler/src/docker.ts
@homarr/nextjs:dev: ../../packages/api/src/router/docker/docker-router.ts
@homarr/nextjs:dev: ../../packages/api/src/root.ts
@homarr/nextjs:dev: ../../packages/api/src/index.ts
@homarr/nextjs:dev: ./src/app/api/trpc/[trpc]/route.ts
Solution
I think I may have a problem with my environment, because even when using the main branch, I have the same error.
The
sshcrypto.node issue can be ignored. It's only a warning, but the module is not used (and also not necessary in the production version)
I mean [ioredis] Unhandled error event: Error: connect ETIMEDOUT looks pretty obvious that it's a redis issue, but thats only whats one option. Do you get any issue shown in the browser when opening the nextjs app on port 3000?Not much : Download the React DevTools for a better development experience: https://react.dev/link/react-devtools react-dom-client.development.js:24869:17
[HMR] connected websocket.js:42:28
Uncaught TRPCClientError: fetch failed
main.js line 1271 > eval:49:37
[Fast Refresh] performing full reload because your application had an unrecoverable error hot-reloader-client.js:339:25
[HMR] connected websocket.js:42:28
[Fast Refresh] performing full reload because your application had an unrecoverable error hot-reloader-client.js:339:25
[HMR] connected websocket.js:42:28
Download the React DevTools for a better development experience: https://react.dev/link/react-devtools react-dom-client.development.js:24869:17
[HMR] connected websocket.js:42:28
Uncaught TRPCClientError: fetch failed
main.js line 1271 > eval:49:37
getServerError node-stack-frames.ts:40
hydrate index.tsx:945
(Async: setTimeout handler)
hydrate index.tsx:923
AsyncFunctionNext self-hosted:800
(Async: async)
pageBootstrap page-bootstrap.ts:23
<anonymous> next-dev.ts:19
(Async: promise callback)
<anonymous> next-dev.ts:18
NextJS 7
React Developer Tools – React
The library for web and native user interfaces
OK I definitely have a problem with my local machine : I tried to spawn the dev branch on another server running Archlinux too and it works on it. I even use the local redis database already running on this machine (it's a testing server for my son and I).
I'll continue digging. Thanks and sorry for the noise
OK FYI, it was because I activated the kernel.unprivileged_userns_clone kernel tunable.
Good to know. Are you able to run it now? Can we mark this as resolved?
Never mind, it worked for a while but now it doesn't work. Still digging
The very odd part is I do see trafic on Redis when I monitor the server's activity
You may close the issue, I'm using a remote dev environment for now
Looking forward to your contribution! Let us know if you need more help later. Cheers
I'm actually working on an OPNsense integration, and trying to understand how it works (not the OPNsense part, I've already created an OPNsense widget for homepage)
Awesome, we'd be happy to accept that
The existing widgets should give you a good idea how it works
which one ? I'm studying the Unifi integration, but I'm not sure that fits
but the Unifi integration will be a good fit for my next integration, which is Omada
If you want it easy, go check the open PR for NFTY on GitHub. There you see everything in one commit
Thanks. Do you have any guidelines regarding what an integration can or can't do ?
Homarr is supposed to control and interface them, not have it's own business logic
If you want to integrate your router as an example, display active clients or network data, and do not allow creating new networks or firewall rules
And if data changes over time, use the subscriptions (websocket)
My question was poorly asked, sorry. Do you have any guide line about what a widget can or can't display ? If I'm to display a graphic of bandwidth going through the firewall, is that allowed ?
Sure
You can implement anything in the widgets really, as long as it makes sense
Great 🙂
We use Mantine, check the docs
Thanks