Session features

When you request a session, you choose which features it grants. Each feature unlocks a specific way to work with the servers in the session. You only get the features you request and that are approved.

Features are used in one of two ways:

  • Web interface — launches directly in your browser from the session’s detail page.
  • CLI — used from the Alpacon CLI after you attach to the session.

Available features

Web terminal

Run commands on a server through a browser terminal. Opens in the browser with Launch, and is also available from the CLI.

$ alpacon websh SERVER

See Terminal access (Websh) and the alpacon websh CLI reference.

File transfer

Transfer files to and from servers, including drag and drop in the browser. Opens in the browser with Launch, and is also available from the CLI.

$ alpacon cp SERVER:/path/to/remote ./local/

See File management (WebFTP) and the alpacon cp and alpacon edit CLI references.

Execute commands

Run commands across one or more servers from the command line. Used from the CLI.

$ alpacon exec SERVER -- COMMAND

See the alpacon exec CLI reference for full usage and flags.

Port forwarding

Securely forward a server port to your local machine. Used from the CLI.

$ alpacon tunnel SERVER -l LOCAL -r REMOTE

See the alpacon tunnel CLI reference for full usage and flags.

Note: Port forwarding must be enabled on the server by its owner. See enable editor and tunnel.

Code editor

Edit files on a server directly in a browser-based code editor. Opens in the browser with Launch.

Note: The editor must be enabled on the server by its owner. See enable editor and tunnel. If no servers in the session have the editor enabled, the feature can’t be launched.

See Code editor.

Privilege elevation (sudo)

Perform actions with elevated (sudo) privileges within the session’s other features. This is not launched on its own—it grants elevated permissions to the terminal, file transfer, and other features you use. Elevated actions may require additional verification depending on your workspace’s sudo and MFA settings.

See sudo with MFA.

Feature summary

FeatureHow it’s usedCLI command
Web terminalBrowser + CLIalpacon websh SERVER
File transferBrowser + CLIalpacon cp SERVER:/remote ./local/
Execute commandsCLIalpacon exec SERVER -- COMMAND
Port forwardingCLIalpacon tunnel SERVER -l LOCAL -r REMOTE
Code editorBrowser
Privilege elevationModifier (no launch)

Changing features after approval

An administrator can change the features on an approved or active session. Updating features may require another approval before the change takes effect. See Use a session.

Last updated: