You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
SSH (Secure Shell) keys provide secure authentication for accessing your rented GPU instances on Spheron. This guide explains how to generate and set up SSH keys.
8
+
9
+
## What are SSH Keys?
10
+
SSH keys use public-key cryptography to authenticate connections:
11
+
12
+
-**Public Key**: Uploaded to Spheron and installed on the GPU server
13
+
-**Private Key**: Kept securely on your local machine
14
+
-**Key Pair**: The public and private keys work together to establish secure connections
15
+
16
+
## Prerequisites
17
+
- Local machine with terminal access
18
+
- Spheron account with some credits
19
+
20
+
This guide will walk you through generating a new SSH key pair and configuring it for use with your Spheron GPU deployments.
21
+
22
+
<Steps>
23
+
### Open a Terminal
24
+
On your computer, open a terminal window.
25
+
26
+
### Run the SSH Key Generation Command
27
+
Type the following command and press Enter:
28
+
29
+
```sh
30
+
ssh-keygen
31
+
```
32
+
33
+
### Choose the Save Location
34
+
Press Enter to accept the default location (usually `~/.ssh/id_rsa`).
35
+
36
+
### Set a Passphrase (Optional)
37
+
You will be prompted to enter a passphrase to secure your key:
38
+
1. To skip, just press Enter twice (once to skip, once to confirm an empty passphrase).
39
+
2. To add extra security, enter a passphrase. (You will need to enter this passphrase whenever you use your SSH key.)
40
+
41
+
### Key Generation Complete
42
+
1. Once the key is generated, you will see output showing where your private and public keys have been saved.
43
+
2. Your public key file is usually named `id_rsa.pub` and is located in the `~/.ssh/` directory.
44
+
45
+
### Upload Your Public Key to Spheron Console
46
+
1. Go to **User Settings > SSH Settings** in your Spheron console.
47
+
2. Upload the contents of your `id_rsa.pub` file.
48
+
49
+
### Or Use CLI to setup SSH Key
50
+
Use the following command to setup your SSH key:
51
+
52
+
```sh
53
+
sphnctl deployment ssh set-key ~/.ssh/id_rsa.pub
54
+
```
55
+
56
+
This will allow you secure, remote access to your rented GPU.
57
+
</Steps>
58
+
59
+
<Callouttype="info">
60
+
If you already have a public key, you may use it and do not need to generate a new one.
**Note:** You can withdraw tokens from your unlocked balance at any time. However, if the tokens are in a locked state, you will not be able to withdraw them until you close your deployment. Upon closing, the locked tokens will be returned to the unlocked state after deducting provider charges and protocol fees.
90
90
</Callout>
91
91
92
-
### Set the C Base Mainnet RPC WSS URL
92
+
### Set the Custom Base Mainnet RPC WSS URL
93
93
94
94
To ensure reliable Base Mainnet deployments, you should supply your own dedicated base mainnet RPC endpoint. Public base mainnet RPCs are rate-limited and can lead to failed or stalled deployments under load.
This section will guide you through the process of deploying a template with no SSH access.
59
+
<Steps>
30
60
### Configure Your Deployment
31
61
1. Select the **Jupyter with PyTorch 2.4.1** template
32
62
- Pre-configured with CUDA support
@@ -58,6 +88,7 @@ This guide will walk you through the steps to deploy and access your application
58
88
- You can install additional packages as needed
59
89
- You can also access the deployment shell to run any command you want and deployment logs to check the status of your deployment
60
90
</Steps>
91
+
</Steps>
61
92
62
93
63
94
## Verification
@@ -78,5 +109,4 @@ nvidia-smi
78
109
- Monitor your memory usage carefully - if your notebook uses more memory than available (Out Of Memory/OOM), the server will automatically terminate and restart your notebook session, causing you to lose any unsaved work. You can check memory usage by running `nvidia-smi` in a notebook cell.
79
110
- Your deployment environment is dedicated to you and not shared with other users, ensuring optimal performance for your workloads.
80
111
81
-
82
-
Congratulations! Your app is now deployed and accessible. If you encounter any issues, reach out to [Spheron Discord Support](https://sphn.wiki/discord).
112
+
Congratulations! You have successfully deployed your rented GPU and can now access it via SSH. If you encounter any issues, reach out to [Spheron Discord Support](https://sphn.wiki/discord).
Copy file name to clipboardExpand all lines: content/rent-gpu/icl.mdx
+54-4Lines changed: 54 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -680,7 +680,7 @@ This is particularly useful when you need to:
680
680
The region must match one of Spheron's [supported region codes](/rent-gpu/supports#supported-regions). If not specified, your application can be deployed in any available region.
681
681
</Callout>
682
682
683
-
#### 2. Exclude Region
683
+
#### 2. Region Exclusion
684
684
Use the `exclude_region` attribute to specify which geographic regions your application should not be deployed in:
685
685
686
686
```yaml
@@ -723,10 +723,36 @@ This is helpful when you:
723
723
- Want to distribute your workload across multiple preferred providers
724
724
725
725
<Callout type="info">
726
-
This works in both `provider` and `fizz` modes. In `fizz` mode, it will select fizz nodes that are connected to your chosen provider(s).
726
+
This works in both `provider` and `fizz` modes. In `fizz` mode, it will select fizz nodes that are connected to your chosen gateway(s).
727
727
</Callout>
728
728
729
-
#### 3. Fizz Node Selection
729
+
#### 4. Provider Exclusion
730
+
731
+
You can exclude a provider from your deployment using the `exclude_provider` attribute:
732
+
733
+
```yaml
734
+
attributes:
735
+
provider_exclude: "0x1234...5678" # Replace with actual provider address
736
+
```
737
+
738
+
You can also exclude multiple providers as a semicolon-separated list:
0 commit comments