Guides
Terminal
A real shell in your browser — PTY when available, ticket-authenticated, role-limited.
Updated Edit this page on GitHub
The terminal gives you the VPS shell without SSH. It is a real terminal emulator (xterm.js) attached to a real shell process.
How to open it
Terminal in the sidebar. Only admin and developer roles can open shells; viewers cannot.
Authentication
When you open the terminal, the panel issues a single-use, 30-second ticket bound to your session. The terminal service redeems that ticket against the panel before spawning your shell — so the shell never trusts a bare WebSocket connection. Terminal content is never logged; only session lifecycle events are.
PTY vs pipe mode
- PTY mode (node-pty available): full interactive shell — colours, tab-completion, resize,
htop. - Pipe mode (fallback): the shell still runs, but without full terminal emulation — the panel says which mode you are in.
Limits
| Limit | Value |
|---|---|
| Concurrent sessions per user | 5 |
| Idle timeout | 15 minutes |
| Hard session cap | 60 minutes (open a new shell after) |