Skip to content

Managing Desktops

Desktops are SAS Analytics Pro container instances managed by the extension. Each desktop has its own configuration, volumes, and lifecycle.

Creating a Desktop

  1. Navigate to Desktops → click New Desktop
  2. Complete the tabbed form:
    • Desktop — name, credentials, order, cadence, version
    • Settings — port configuration, web access options
    • Mounts — local directories and network shares (available after first save)
  3. Click Create

Each desktop must have a unique name. The name is used to generate Docker volume names and container names.

Starting and Stopping

  • Start — pulls the image (if needed), provisions license and certificates, creates volumes, and starts the container
  • Stop — stops and removes the container (volumes are preserved)

Start and stop operations run asynchronously on the backend, so they survive UI navigation. The desktop card shows real-time status updates during operations.

Desktop Fleet View

The Home page shows a Desktop Fleet card with:

  • Live Docker stats (CPU and memory usage) for running desktops
  • Start/stop controls
  • Card view and list view toggle

Volumes

Each desktop creates isolated named volumes:

Volume Purpose
{name}-data SAS workspace data
{name}-sasinside License files and configuration
{name}-code-server VS Code extension data

Volumes persist across container restarts. Deleting a desktop stops the container and removes it, but volumes are preserved unless manually removed.

Deleting a Desktop

Deleting a desktop:

  1. Stops the running container (if any)
  2. Removes the container
  3. Deletes the desktop configuration from the database

Warning

Desktop deletion does not remove Docker volumes. To reclaim disk space, remove volumes manually:

docker volume rm {name}-data {name}-sasinside {name}-code-server