Connect to servers

Access registered servers via browser terminal (Websh).

Quick access

From server list

  1. Go to Servers page
  2. Find the server you want to access
  3. Click Console on the server row
  4. Websh terminal opens in a new tab

From server detail

  1. Click server name to open detail page
  2. Click Websh button in the top
  3. Terminal opens in a new tab

Access permissions

To connect to a server, you must meet these conditions:

  • Server status is Connected
  • You belong to a user group assigned to the server
  • You’re a workspace member

Account selection

When connecting, you choose which account to use on the remote server—either your own Alpacon account or a system account (if you have sudo privilege).

For details on account types, sudo privilege, and MFA authentication, see Account selection.

Using Websh terminal

Basic features

Execute commands:

  • All standard Linux commands available
  • Sudo privileges available when connected with sudo privilege

Multiple sessions:

  • Multiple simultaneous sessions to the same server
  • Each session operates independently

Session persistence:

  • Sessions persist even if you close the browser
  • Auto-terminate after inactivity timeout (configurable)

Keyboard shortcuts

See Terminal shortcuts for detailed shortcuts

Multiple server access

Connect to multiple servers simultaneously:

  1. Connect to first server from server list
  2. Open another server in a new tab
  3. Switch between browser tabs to manage

Session management

View active sessions:

  1. Click Websh menu
  2. View list of active sessions
  3. Click session to reconnect or terminate

Terminate session:

  • Type exit in terminal
  • Or terminate from Websh session management

Troubleshooting

Connect button is disabled:

  • Verify server status is Connected
  • Confirm you’re assigned to a user group

Terminal won’t open:

  • Disable popup blocker in browser
  • Refresh browser and retry

Commands won’t execute:

  • Check network connection
  • Session may have expired - reconnect

Security

Authentication:

  • Login with your IAM user account
  • Additional MFA required if enabled

Audit logging:

  • All command executions are logged
  • View in server detail > Activity tab