Connect to a Workload with VS Code over SSH

You can connect VS Code to a running container over SSH for development. The interactive SSH endpoint gives you a stable, secure connection to the container.

How to run SSH workloads

• Use the provided Ubuntu applications.
• Create your own SSH application: Create a Docker application to install and expose SSH.
• Or run your own SSH container.

Latest Ubuntu dev Docker images are recommended.

Obtain workload SSH credentials

Open the workload in the dashboard. When it is Running, scroll to the Interactive Endpoints section on the right of the workload details page.

Click Connect to reveal the SSH URL and Password for your container.

ssh -o strictHostKeyChecking=no -p <port> <username>@<hostname>

For example:

ssh -o strictHostKeyChecking=no -p 8001 aac@aac5.amd.com

The Password field contains the password for the SSH connection.

VS Code configuration

Install dependencies

Install the Remote - SSH extension to connect to remote SSH servers.

Configure the SSH connection

Copy the SSH URL from Plexus and add it to your SSH config.

• Add it to the .ssh/config file in your home directory.

Host workload-aac5
  HostName aac.amd.com
  strictHostKeyChecking no
  ServerAliveInterval 60
  Port 8001
  User aac

• Or set it up in VS Code: Connect to Host → Add New SSH Host → press Enter → choose the SSH config file to update (this saves the connection in ~/.ssh/config).

Connect to the configured SSH host

In VS Code, open Remote Explorer on the left. Your host will appear in the list.

1. Click Connect.
2. When prompted, enter the password from the Password field.

Once connected, you can run commands, check logs, forward ports, and use VS Code inside the container.

Important notes

• To keep the connection alive, use the ServerAliveInterval parameter in your SSH config.
• To reuse datasets, use paths under /home/aac; this directory is on a user-isolated data volume mounted in every workload.