1.5.1 Windows

Connecting from Windows

SSH Connection

Windows provides several SSH client options:

Client Built-in Notes
PowerShell Yes (Windows 10+) Recommended for most users
Windows Terminal Yes (Windows 11) Modern terminal with tabs
PuTTY No (download required) Traditional SSH client
MobaXterm No (download required) Feature-rich with built-in SFTP

Using PowerShell or Windows Terminal

  1. Click Connections on your workspace
  2. Under CLI Connections, select your SSH key
  3. Click Use this SSH Key
  4. Copy the SSH command
  5. Open PowerShell or Windows Terminal
  6. Paste and run the command
ssh -i C:\Users\YourName\.ssh\your-key.pem ec2-user@<workspace-ip>
Warning

After selecting your SSH key, you have 60 seconds to connect. If the timer expires, click Use this SSH Key again.

DCV Remote Desktop (Browser)

  1. Click Connections on your workspace
  2. Click DCV (Browser)
  3. A new browser tab will open with your remote desktop

Your browser may show a security warning about a self-signed certificate. Click Advanced and proceed.

DCV Remote Desktop (Client)

For better performance, especially with graphics-intensive work:

  1. Download and install the NICE DCV Client
  2. Click Connections on your workspace
  3. Click DCV (Client)
  4. Allow your browser to open the DCV client

Web IDE (VS Code)

  1. Click Connections on your workspace
  2. Click Open IDE
  3. A new browser tab will open with VS Code
  4. Click Trust when prompted

Troubleshooting

Issue Solution
Permission denied Ensure your key file is in a secure location with restricted permissions
Connection timeout Verify your IP is whitelisted in the security group
PuTTY can’t use .pem Convert to .ppk format using PuTTYgen