Skip to content

Connect to a Workload via SSH

After you submit a workload, it moves through the queue and starts when resources are available. When the status changes from Pending to Running, you can connect to it.

Open workload details

Open the workload from the Workloads page. When it is Running, click the workload to open its details. On the right you will see:

  • Interactive Endpoints
  • Service Terminal

Interactive Endpoints and Service Terminal sections

You can connect to the container using either of these methods. Below is an overview of both options.

Service terminal

The Service Terminal opens a websocket-based terminal to the container. This method is not recommended for development. It is useful for quick admin or troubleshooting but may timeout or disconnect.

  • Limitations: Not suitable for long-running tasks or development.
  • Usage: Click Service Terminal to open the terminal. You can interact with the container but it may disconnect when idle or due to connection issues.

Service Terminal connection

For development or a stable SSH connection, use Interactive Endpoints. You get a secure SSH connection to the container using SSH keys. You can connect from any internet-connected machine using the provided details.

Locate the Interactive endpoints section

When the workload is Running, scroll to the Interactive Endpoints section on the right. You will see:

  • SSH Port: The port to use for the SSH connection.
  • Secret Key: The private key for SSH authentication.

Interactive Endpoints with SSH port and Secret Key

Connect

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

SSH URL and password for 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 initial connection.

Connect from your local terminal

  1. Open a terminal on your machine.
  2. Copy the SSH URL and paste it into your terminal.

SSH command in local terminal

Example:

ssh -o strictHostKeyChecking=no -p 8001 aac@aac5.amd.com
  1. When prompted, enter the password from the Password field to authenticate.

Once connected, you can run commands, check logs, and work inside the container.