Shell & Terminal

DATAZONE Control provides remote terminal access directly in the browser. A secure WebSocket connection is established through the agent, enabling command-line access to every managed host.

Shell Types

Inline Shell

The inline shell is integrated into the detail modal of a host:

1. Open a host in the detail modal
2. Select the Shell tab (or PowerShell for Windows)
3. Enter commands and press Enter

The inline shell is suitable for quick commands and status queries.

WebShell (Separate Window)

The WebShell opens a full-featured terminal in a separate browser tab:

1. Right-click on a host → Open Shell
2. Or: Detail modal → Shell tab → Open in New Window

The WebShell provides:

• Full-screen terminal
• Better keyboard support
• Multiple simultaneous sessions
• Copy/paste support

Platform-Specific

Linux / PVE / PBS / OPNsense

On these systems, a Bash shell (or sh on FreeBSD) is started:

$ whoami
root
$ uptime
 14:23:01 up 42 days, 3:15, 1 user
$ df -h /
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1        50G   12G   36G  25% /

Windows

On Windows systems, a PowerShell console is started:

PS C:\> Get-Service | Where Status -eq Running | Select -First 5
PS C:\> Get-ComputerInfo | Select OsName, OsVersion
PS C:\> Get-Process | Sort CPU -Descending | Select -First 10

Security

• All terminal data is transmitted over an encrypted WebSocket connection
• Shell access requires the corresponding module permissions
• Every shell session is logged (audit log)
• Sessions are automatically terminated after inactivity
• The agent executes commands with the configured permissions

Keyboard Shortcuts

Shortcut	Function
Enter	Execute command
Ctrl+C	Cancel running command
Ctrl+D	End session (Linux)
Tab	Autocompletion
Arrow Up/Down	Command history

Limitations

• Interactive programs with complex TUI (e.g., vim, htop) have limited functionality in the inline shell -- use the WebShell for these
• Maximum output length per command is limited
• Long-running commands are terminated after a timeout

For Extensive Work

Use the WebShell or an SSH tunnel for longer terminal sessions. The inline shell is optimized for quick status queries and short commands.