Connect on Linux

---

Use the tabs below to connect your Spark ProStation from Linux using either TGX (remote desktop) or SSH (command line).

TGX

Connect with TGX

Before You Begin

1. Install TGX Receiver

Install the standalone TGX Receiver for Linux:

Get TGX Receiver for Linux

2. Ensure Your ProStation Is Ready

On the Dashboard, confirm that the Connect button is visible and available next to your workstation. This indicates your ProStation is up and ready to accept connections.

Need to create or launch a ProStation?

Refer to the Creating Your ProStation guide before continuing.

Connecting with TGX

Step 1: Open Spark Cloud Studio

Open a web browser and navigate to Spark Cloud Studio.

Step 2: Sign In to Your Account

Sign in with your account. After authentication, you will be redirected to the dashboard.

Step 3: Create or Start Your Workstation

From the Workstations section:

• If you do not have a workstation yet, follow the Workstation Creation Guide.
• If you already have one, click Start.

Step 4: Wait for Running Status

Wait until the workstation status becomes Running and the Connect button is available.

First launch may take a few minutes

When a newly created workstation is launched for the first time, startup may take approximately 5 to 10 minutes while provisioning and resource allocation complete. Subsequent starts typically take less than 2 minutes.

Step 5: Download the .tgx Connection File

Click Connect on your workstation card. A time-limited .tgx file is downloaded to your Downloads folder.

The .tgx file is single-use and time-limited

This file expires in about 5 minutes and can only be used once. If it expires, click Connect again to generate a new one.

Step 6: Open the .tgx File

Open the downloaded .tgx file to launch TGX Receiver.

If double-click does not work

Run this command in terminal (replace file name as needed):

tgx-receiver --connect ~/Downloads/your-prostation.tgx

Step 7: Access the Remote Session

TGX Receiver will establish the connection and open your remote desktop.

Linux TGX Keyboard Shortcuts

Session Action	Keyboard Shortcut
Minimize Session	Ctrl + Alt + N
Maximize Session	Ctrl + Alt + M
Restore Window	Ctrl + Alt + W
Toggle Fullscreen	Ctrl + Alt + S
Enable Multi-Screen	Ctrl + Alt + D
Disconnect Session	Ctrl + Alt + X

SSH

Connect with SSH

Before You Begin

1. Ensure SSH Access Details Are Available

Make sure your workstation is in Running state so SSH credentials are available from the dashboard.

Before you continue

If you do not have a workstation yet, create one first using the Workstation Creation Guide.

Connecting with SSH

Step 1: Open Spark Cloud Studio

Open your browser and go to Spark Cloud Studio Dashboard.

Step 2: Select SSH from Connect dropdown

Click the Connect dropdown and choose SSH.

Step 3: Download PEM and copy SSH command

In the SSH panel:

• Click Download PEM
• Copy the generated SSH command

Step 4: Run the SSH command

Open terminal and run:

cd ~/Downloads
chmod 400 spark-workstation-name.pem
ssh -i spark-workstation-name.pem administrator@<your-ip>

On first connection, type yes to accept the host fingerprint.

---

Don't forget to stop your workstation

Disconnecting or logging out does not stop your ProStation. It continues running and billing. If you are done, go to the Dashboard and click Stop.