Troubleshooting

License Issues

If license validation fails:

1. Verify your SAS API credentials are correct (Account → SAS Credentials)
2. Check that your order number is valid
3. Ensure your SAS entitlement hasn't expired

Desktop Won't Start

1. Check Docker Desktop is running
2. Verify the SAS image is accessible (the extension pulls it automatically)
3. Check the operation status on the desktop card for error messages
4. Ensure you haven't exceeded your tier's desktop limit

First start is slow

The first start downloads a ~4 GB SAS image. Subsequent starts reuse the cached image.

Mount Issues

Mount not working after container start

1. Verify the source directory exists and is accessible
2. Check Docker Desktop's file sharing settings — the source path must be in a shared directory
3. On macOS, ensure the path is under /Users, /tmp, /private, or another Docker-shared path
4. Review the mount status in the UI for validation errors

"Target path conflicts with reserved container path"

These paths are reserved and cannot be used as mount targets:

• /opt/sas — SAS installation directory
• /sasinside — License file directory
• /sasuser — SAS user directory
• /proc, /sys, /dev — Linux system directories

Choose a different target path like /data, /workspace, or /mnt/mydata.

"Permission denied" error

• On macOS, check System Preferences → Security & Privacy → Files and Folders
• On Linux, ensure the directory has appropriate read permissions for the Docker daemon
• Try using Read-Only access mode if you only need to read files

Network share not connecting

• Verify the UNC path format: //server/share (forward slashes)
• Check that the credential profile has the correct username, password, and domain
• Ensure the network share is accessible from your machine
• Network shares require the Docker host to have network access to the file server

Session Limits

Tier	Session Limit
Starter (Free)	30 minutes
Personal	4 hours
Professional+	Unlimited

If your desktop stops unexpectedly, check your tier's session limit. Sign in or upgrade for longer sessions.

Reporting Issues

Please report bugs via the Selerity website.

Include:

• What you were doing when the issue occurred
• What you expected vs. what happened
• Screenshots if applicable
• Docker Desktop version (docker version)
• Operating system and architecture
• Extension version (docker extension ls | grep selerity)