SSH Access

schedule Created: December 3, 2025 at 03:13 AM
update Last Updated: December 3, 2025 at 03:13 AM

Remote Access Guide

This document explains how to connect to servers created by StreamGPU. It is written to be easy to follow even if you have little technical background.

💡 Quick summary
  • After creating a server, download the private key file from the dashboard.
  • Move the downloaded file to a secure folder and set proper permissions.
  • Copy the connection command shown on the dashboard and use it to connect.

Step 1: Download the private key

When you create a server, a pop-up appears. Click the "Download Security Key" button in that window to save the key file (for example: my-server-abc123.pem).

⚠️ Important
The private key can only be downloaded immediately after server creation. For security reasons StreamGPU does not keep a copy. If you miss the download you cannot retrieve the same key — you will need to recreate the server. Store the key in a safe place.

Step 2: Move the key and set permissions

Move the downloaded key to a secure folder and make sure only you can read it.

Mac / Linux

Open a Terminal and run:

mkdir -p ~/.ssh/streamgpu
mv ~/Downloads/<downloaded_filename> ~/.ssh/streamgpu/<downloaded_filename>
chmod 600 ~/.ssh/streamgpu/<downloaded_filename>

Windows (PowerShell)

Open PowerShell (run as Administrator if needed) and run:

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.ssh\streamgpu"
Move-Item -Path "$env:USERPROFILE\Downloads\<downloaded_filename>" -Destination "$env:USERPROFILE\.ssh\streamgpu\<downloaded_filename>"
icacls "$env:USERPROFILE\.ssh\streamgpu\<downloaded_filename>" /inheritance:r /grant:r "$env:USERNAME:(R)"

Note: Windows does not support chmod 600 the same way as Linux — use icacls as shown above.

Step 3: Connect to the server

Copy the connection command shown on the dashboard. It looks similar to:

ssh -i ~/.ssh/streamgpu/<filename> awesome@<serveraddress> -p <portnumber>
📌 Default username
The default username for servers created by StreamGPU is awesome. Use this when connecting.
💡 Tip
The dashboard provides a Copy button that copies the entire command so you can paste it into your terminal.

Troubleshooting

  • I missed the private key download
    The private key is shown only once during server creation and StreamGPU does not retain it. If you missed the download you cannot access that server and must recreate it.
  • "Permission denied" error
    Re-check the permission steps above — the key file must be readable only by you.
  • Can't connect
    Verify the server address and port are correct. If you are on corporate or public Wi‑Fi the network may block SSH — contact your network administrator.
  • Warning on first connection
    You may see a host key confirmation prompt the first time you connect. This shows the server's fingerprint. If possible, compare it with the fingerprint shown in the dashboard or provided by your administrator. If it does not match, stop and contact support. If you are confident it is correct, type yes to continue.

If you need more help, contact customer support.