# Unable to start web terminal service

**URL:** <https://forum.hestiacp.com/t/unable-to-start-web-terminal-service/17636>\
**Category:** Install & Set-Up\
**Created:** [February 4, 2025, 10:39am UTC](https://forum.hestiacp.com/t/unable-to-start-web-terminal-service/17636 "2025-02-04T10:39:36Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![Gohrum](https://forum.hestiacp.com/user_avatar/forum.hestiacp.com/gohrum/32/7979_2.png) [@Gohrum](https://forum.hestiacp.com/u/Gohrum)\
**Post date:** [February 4, 2025, 10:39am UTC](https://forum.hestiacp.com/t/unable-to-start-web-terminal-service/17636/1 "2025-02-04T10:39:36Z")

</div>

Hello,

I have two servers which updated automatically (one to 1.9 and the other to 1.9.1). Both of them now show the “web-terminal” process under settings, and both of them have it disabled.

When i try to enable the service i get this error in the logs: Service failed to start (Name: web-terminal).

I open this post because it happens in both my servers (one is Ubuntu 22 and the other Ubuntu 24).

Any light on what can be happening?  
Thanks

---

<div class="post-metadata">

**Author:** ![heart1010](https://forum.hestiacp.com/letter_avatar_proxy/v4/letter/h/9d8465/32.png) [@heart1010](https://forum.hestiacp.com/u/heart1010)\
**Post date:** [February 4, 2025, 10:59am UTC](https://forum.hestiacp.com/t/unable-to-start-web-terminal-service/17636/2 "2025-02-04T10:59:49Z")

</div>

Have you tried to restart the service in a terminal?

```bash
v-restart-service hestia-web-terminal

```

after that it was green in hestia on my installation.

---

<div class="post-metadata">

**Author:** ![Gohrum](https://forum.hestiacp.com/user_avatar/forum.hestiacp.com/gohrum/32/7979_2.png) [@Gohrum](https://forum.hestiacp.com/u/Gohrum)\
**Post date:** [February 4, 2025, 12:57pm UTC](https://forum.hestiacp.com/t/unable-to-start-web-terminal-service/17636/3 "2025-02-04T12:57:20Z")

</div>

yes, it worked. Why does the command works but the service is not able to start using the web interface?

---

<div class="post-metadata">

**Author:** ![TCHT](https://forum.hestiacp.com/letter_avatar_proxy/v4/letter/t/fbc32d/32.png) [@TCHT](https://forum.hestiacp.com/u/TCHT)\
**Post date:** [February 4, 2025, 1:50pm UTC](https://forum.hestiacp.com/t/unable-to-start-web-terminal-service/17636/4 "2025-02-04T13:50:27Z")

</div>

Same doubt here

---

<div class="post-metadata">

**Author:** ![nu01](https://forum.hestiacp.com/user_avatar/forum.hestiacp.com/nu01/32/7639_2.png) [@nu01](https://forum.hestiacp.com/u/nu01)\
**Post date:** [March 6, 2025, 2:20pm UTC](https://forum.hestiacp.com/t/unable-to-start-web-terminal-service/17636/5 "2025-03-06T14:20:59Z")

</div>

> [@heart1010](#):
>
> `v-restart-service hestia-web-terminal`

Actually, yeah. Why does this happen? There is a newer post as well, but there is no response on that either.

> [@Enable and Start hestia-web-terminal by hand in Debian 12?](https://forum.hestiacp.com/t/enable-and-start-hestia-web-terminal-by-hand-in-debian-12/17941):
>
> In debian 12, after selecting “Yes” in Web Terminal plugins list, it was giving me a “connection error” when trying to use it inside an account with shell assigned (not nologin value). Then I have enable the service with: systemctl enable hestia-web-terminal.service and then I have started it with: systemctl start hestia-web-terminal.service and then it seems to run well. Seems there is also this command available: v-restart-service hestia-web-terminal but it is not “enabling” the servic…

---

<div class="post-metadata">

**Author:** ![nu01](https://forum.hestiacp.com/user_avatar/forum.hestiacp.com/nu01/32/7639_2.png) [@nu01](https://forum.hestiacp.com/u/nu01)\
**Post date:** [March 10, 2025, 2:32pm UTC](https://forum.hestiacp.com/t/unable-to-start-web-terminal-service/17636/6 "2025-03-10T14:32:29Z")

</div>

@eris sorry to tag you, but even the cli command is not working anymore. There was a php upgrade from main repo before I tried. Any idea how to get it to activate?

Edit/Update:. It finally worked. I went through the `v-add-sys-web-terminal` & `v-delete-sys-web-terminal` & the `hestia-web-terminal`. Found that for some weird reason nodejs even though installed was located at `usr/include/node` instead of `usr/local/bin/node`.  
I uninstalled web-ternimal which also uninstalled the current node from include and then reinstalled manually. Then it worked. Very odd, that everytime I reboot the server, the node and npm used to vanish. Not sure why though.

---

<div class="post-metadata">

**Author:** ![Servet](https://forum.hestiacp.com/letter_avatar_proxy/v4/letter/s/b9e5f3/32.png) [@Servet](https://forum.hestiacp.com/u/Servet)\
**Post date:** [December 3, 2025, 12:38pm UTC](https://forum.hestiacp.com/t/unable-to-start-web-terminal-service/17636/7 "2025-12-03T12:38:25Z")

</div>

If the web-terminal service doesn’t start and remains red, you’ll need to make a few minor adjustments, and if Node.js 22 is installed on the server, uninstall it and install Node.js 20.

1 - Disable Web Terminal from Plugins  
Settings-\>Configure-\>Plugins-\>Web Terminal: No → Save

2 - Configure SSH Access  
Users-\>Edit-\>SSH Access: bash → Save

3 - Completely clear the existing NodeSource sources and keys  
rm -f /etc/apt/sources.list.d/nodesource.list  
rm -f /etc/apt/sources.list.d/nodesource.list.save  
rm -f /usr/share/keyrings/nodesource.gpg  
rm -f /usr/share/keyrings/nodejs.gpg

4 - Re-download and install the NodeSource GPG key  
curl -fsSL [https://deb.nodesource.com/gpgkey/nodesource.gpg.key](https://deb.nodesource.com/gpgkey/nodesource.gpg.key) | gpg --dearmor -o /usr/share/keyrings/nodesource.gpg

5 - Add Node.js 20 repository manually  
echo “deb [signed-by=/usr/share/keyrings/nodesource.gpg] [https://deb.nodesource.com/node\_20.x](https://deb.nodesource.com/node_20.x) jammy main” \> /etc/apt/sources.list.d/nodesource.list

6 - Update Apt and install Node.js  
apt update  
apt install -y nodejs

7 - Check  
node -v  
npm -v  
expected;  
v20.x.x  
10.x.x

8 - Enable Web Terminal from Plugins  
Settings-\>Configure-\>Plugins-\>Web Terminal: Yes → Save

9 - Start the service  
systemctl enable hestia-web-terminal.service  
systemctl start hestia-web-terminal.service

10 - Restart the server  
sudo reboot

Finish → Go to the control panel and click the “\>\_” icon next to the folder icon in the top right.
