# Headplane app install Fail - "ENOSPC: System limit for number of file watchers reached"

**URL:** <https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490>\
**Category:** Support apps\
**Tags:** headplane, english\
**Created:** [April 15, 2025, 7:05pm UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490 "2025-04-15T19:05:56Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![m.shoals](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/m/82dd89/32.png) [@m.shoals](https://forum.yunohost.org/u/m.shoals)\
**Post date:** [April 15, 2025, 7:05pm UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490/1 "2025-04-15T19:05:56Z")

</div>

**What type of hardware are you using** : VPS bought online  
**What YunoHost version are you running** : 12.0.13  
**What app is this about** : Headplane

### Describe your issue

Thank you for reading.

Seeking a solution for a failed installation of Headplane on a Linode VPS. Prior installation of Headscale and DEX when smoothly. I did not attempt to configure/add a client prior to the Headplace install.

Relevant log snippet:  
2025-04-15 15:35:46,976: DEBUG - Done in 8.9s using pnpm v10.8.1  
2025-04-15 15:35:47,013: DEBUG - + ynh\_hide\_warnings pnpm build  
2025-04-15 15:35:47,014: DEBUG - + pnpm build  
2025-04-15 15:35:47,350: DEBUG -  
2025-04-15 15:35:47,350: DEBUG - \> headplane@ build /var/www/headplane  
2025-04-15 15:35:47,350: DEBUG - \> react-router build && vite build -c server/vite.config.ts  
2025-04-15 15:35:47,350: DEBUG -  
2025-04-15 15:35:51,592: DEBUG - node:internal/fs/watchers:247  
2025-04-15 15:35:51,592: DEBUG - const error = new UVException({  
2025-04-15 15:35:51,593: DEBUG - ^  
2025-04-15 15:35:51,593: DEBUG -  
2025-04-15 15:35:51,593: DEBUG - Error: ENOSPC: System limit for number of file watchers reached, watch ‘/var/www/headplane/.local/share/pnpm/store/v10/files/af/3e41c6f7998bf13dbc7c2c2e6358d00a60d79bdde5edb36a70c679491776d8c3a0cd2f230a38758c920908ac7e0302a22e43574a836b369e0c8120f2de78f8’  
2025-04-15 15:35:51,593: DEBUG - at FSWatcher. (node:internal/fs/watchers:247:19)  
2025-04-15 15:35:51,593: DEBUG - at Object.watch (node:fs:2550:36)  
2025-04-15 15:35:51,593: DEBUG - at createFsWatchInstance (file:///var/www/headplane/node\_modules/.pnpm/vite@6.0.6\_@types+node@22.10.7\_jiti@1.21.7\_tsx@4.19.2\_yaml@2.7.0/node\_modules/vite/dist/node/chunks/dep-0AosnpPU.js:27718:17)

### Share relevant logs or error messages

[https://paste.yunohost.org/raw/xucepeyoro](https://paste.yunohost.org/raw/xucepeyoro)

---

<div class="post-metadata">

**Author:** ![tituspijean](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tituspijean/32/3584_2.png) [@tituspijean](https://forum.yunohost.org/u/tituspijean)\
**Post date:** [April 15, 2025, 7:31pm UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490/2 "2025-04-15T19:31:59Z")

</div>

Welcome!

This looks like a limit from Linode’s VPS. Can you try following what’s suggested there? [node.js - Nodemon Error: "System limit for number of file watchers reached" - Stack Overflow](https://stackoverflow.com/a/55543310)

They suggest to double the number returned by `cat /proc/sys/fs/inotify/max_user_watches`

Note that I was not able to make that app work after installation.  
Edit: ah, it’s a bit quirky. The app needs its own domain, installed at its root, but expects to be opened on the `/admin` path.

---

<div class="post-metadata">

**Author:** ![m.shoals](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/m/82dd89/32.png) [@m.shoals](https://forum.yunohost.org/u/m.shoals)\
**Post date:** [April 15, 2025, 7:57pm UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490/3 "2025-04-15T19:57:22Z")

</div>

Thank you. That fixed my issue. Here is the command I ran to increase the watcher countill:  
`echo fs.inotify.max_user_watches= 131070 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p`

The Headplane installation completed successfully. However, I have a new issue now.

On launching Headplane in the browser, it asks me to enter `headscale apikeys create` in the console to generate and authenticate with a new API key. Here is what I see at the console of my Linode VPS:

```auto
user@host:~$ headscale apikeys create
-bash: headscale: command not found

```

How and where do I execute `headscale apikeys create`?

Thank you, again.

---

<div class="post-metadata">

**Author:** ![tituspijean](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tituspijean/32/3584_2.png) [@tituspijean](https://forum.yunohost.org/u/tituspijean)\
**Post date:** [April 15, 2025, 8:26pm UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490/4 "2025-04-15T20:26:04Z")

</div>

```auto
sudo yunohost app shell headscale
# then
./headscale apikeys create

```

---

<div class="post-metadata">

**Author:** ![lnewlf](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/l/6f9a4e/32.png) [@lnewlf](https://forum.yunohost.org/u/lnewlf)\
**Post date:** [April 29, 2025, 10:40am UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490/5 "2025-04-29T10:40:46Z")

</div>

Hi.  
thanks for this hint. Is it possible to get the info how to get the apikey in the App-Catalogue?  
Keep up the marvelous work. 😁

---

<div class="post-metadata">

**Author:** ![lnewlf](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/l/6f9a4e/32.png) [@lnewlf](https://forum.yunohost.org/u/lnewlf)\
**Post date:** [April 29, 2025, 12:01pm UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490/6 "2025-04-29T12:01:08Z")

</div>

one more word: I followed your hint and got a API-Key. copied over to headplane but got

 ![Screenshot 2025-04-29 at 12-56-25 Headplane](https://forum.yunohost.org/uploads/default/original/2X/d/d480c0accc10660a467be308bb8d5824ca824684.png)

still a little dismissed… 😶‍🌫️

---

<div class="post-metadata">

**Author:** ![tituspijean](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tituspijean/32/3584_2.png) [@tituspijean](https://forum.yunohost.org/u/tituspijean)\
**Post date:** [April 29, 2025, 6:33pm UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490/7 "2025-04-29T18:33:51Z")

</div>

> [@lnewlf](#):
>
> Is it possible to get the info how to get the apikey in the App-Catalogue?

Even better, in the [next version](https://github.com/YunoHost-Apps/headplane_ynh/pull/35) you will get the hint directly in the app.

 ![image](https://forum.yunohost.org/uploads/default/original/2X/5/5866d6a44b24f994b6771c8d73156d1f7cf1002e.png)

> [@lnewlf](#):
>
> I followed your hint and got a API-Key. copied over to headplane but got

Are you _sure_ you copied it correctly? It has two parts separated by a dot, correct?

I’m also investigating OIDC connection (with the Single Sign-On button), but do not expect it to be integrated any time soon.

---

<div class="post-metadata">

**Author:** ![Yunoadmin](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/y/f475e1/32.png) [@Yunoadmin](https://forum.yunohost.org/u/Yunoadmin)\
**Post date:** [May 12, 2025, 5:37pm UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490/8 "2025-05-12T17:37:14Z")

</div>

Hi Tituspijean  
Thank you and i have see it by the Installation on Thursday. 😉  
Great Job 😉

---

<div class="post-metadata">

**Author:** ![system](https://forum.yunohost.org/uploads/default/original/2X/f/f59fe8e3ee6b100b4f574d30d6e30479c68b89f0.png) [@system](https://forum.yunohost.org/u/system)\
**Post date:** [May 27, 2025, 5:37pm UTC](https://forum.yunohost.org/t/headplane-app-install-fail-enospc-system-limit-for-number-of-file-watchers-reached/36490/9 "2025-05-27T17:37:23Z")

</div>

Closed on May 27, 2025, 5:37pm UTC

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