Web Terminal

What is the Web Terminal?

The web terminal lets you access your hosting's command line directly from your web browser – without installing an SSH client. It uses the xterm.js terminal emulator that runs in the browser and provides a full-featured terminal environment.

Where to find the Web Terminal

You can open the web terminal from the user panel in two ways:

• In the hosting detail – Deployments tab
• In the hosting detail – directly from the overview

Clicking the button opens the terminal in a new browser window. The host, port, and username fields are automatically pre-filled from your hosting settings.

How the connection works

1. Click the Connect button
2. The Laravel application requests a one-time authentication token from the daemon
3. A WebSocket connection opens using this token
4. A PTY (pseudo-terminal) shell starts inside your hosting's Docker container
5. All commands execute as your hosting's SSH user

Features and capabilities

• Full bash shell – supports xterm-256color with colored output
• Interactive programs – you can use vim, nano, htop, mc, and more
• Auto-reconnect – the token is automatically renewed every 12 minutes
• Keep-alive – a ping is sent every 15 seconds to keep the connection active
• Idle timeout – after 30 minutes of inactivity, the connection is automatically closed

Practical tips

• The web terminal is ideal for quick tasks – checking logs, restarting services, or editing configuration files
• For longer work sessions, we recommend a traditional SSH connection via a terminal client
• If the connection drops, simply click Connect again – the token will be automatically renewed
• The terminal runs inside your hosting's Docker container, so you have access to all files and services of your project

Troubleshooting

• Terminal won't connect – check that your hosting is active and the container is running
• Connection keeps dropping – check your internet connection stability. The terminal automatically disconnects after 30 minutes of inactivity
• Characters display incorrectly – make sure your browser supports UTF-8 encoding