# SSH ## About SSH #### What is SSH? **SSH** (Secure Shell Protocol) is a protocol for securely connecting to remote servers. It encrypts your connection, allowing you to: * Log in safely * Run commands remotely * Transfer files without exposing your data #### SSH Connection on Pictor You can access Linux instances rented on Pictor using SSH. When connecting via SSH, you authenticate using a private key file on your local machine. To establish an SSH connection to your Pictor Linux Instances, you need an SSH key pair. This pair consists of: * **Public Key**: This key will be added to the Pictor Instance configuration to grant access. * **Private Key**: This key will be used for authentication during instance connection. You must keep it absolutely secret on your local machine. If you're unsure whether you already have an SSH key, you can [check for existing SSH keys](https://docs.pictor.network/docs/services/gpu-renting/connection-methods/ssh#check-for-existing-ssh-keys). If you don't already have an SSH key, you must [generate a new SSH key](https://docs.pictor.network/docs/services/gpu-renting/connection-methods/ssh#generate-a-new-ssh-key). If you already have an SSH key, you must [add your SSH **public key** to your Pictor account](https://docs.pictor.network/docs/services/gpu-renting/connection-methods/ssh#add-ssh-key-to-pictor-account) for SSH connection. To maintain account security, you should regularly [review your SSH keys](https://docs.pictor.network/docs/services/gpu-renting/connection-methods/ssh#review-ssh-keys) and delete any keys that are invalid or have been compromised. *** ## Check for existing SSH keys Before [generating a new SSH key](https://docs.pictor.network/docs/services/gpu-renting/connection-methods/ssh#generate-a-new-ssh-key), you should check for existing keys on your local machine. {% stepper %} {% step %} #### Open Terminal Open a Terminal application on your machine. For example, use PowerShell or Command Prompt on Windows, Terminal.app on macOS, or a Terminal Emulator (like Gnome Terminal or Konsole) on Linux. {% endstep %} {% step %} #### Check for existing SSH keys. Enter the command to see if existing SSH keys are present. * On Windows PowerShell, enter ```powershell Get-ChildItem -Path $HOME\.ssh -Force ``` * On Windows Command Prompt, enter: ```cmd dir %USERPROFILE%\.ssh ``` * On macOS Terminal.app, enter: ```bash ls -al ~/.ssh ``` {% endstep %} {% step %} #### Check the directory listing * If you already have a public SSH key, you will see:
* If you don't have a public SSH key, you will see:
{% endstep %} {% step %} #### Generate a new SSH key or Add an existing one. * If you don't have a public and private key pair, or don't wish to use any existing key, you can [generate a new SSH key](https://docs.pictor.network/docs/services/gpu-renting/connection-methods/ssh#generate-a-new-ssh-key). * If you want to use your existing one, you can [add your SSH key to your Pictor account](https://docs.pictor.network/docs/services/gpu-renting/connection-methods/ssh#add-ssh-key-to-pictor-account). {% endstep %} {% endstepper %} *** ## Generate a new SSH key If you don't already have an SSH key pair or don't wish to use any existing key, you can generate a new SSH key. **Follow the steps below to generate a key pair in your terminal:** {% hint style="info" %} **Note**: The `ssh-keygen` command is a standard utility and is executed the same way across all terminal applications. We will guide you through the process using Windows PowerShell. {% endhint %} {% stepper %} {% step %} #### Enter the Keygen Command Type this command into the PowerShell and press Enter ```powershell ssh-keygen -t ed25519 -C "your_email@example.com" ``` {% hint style="info" %} -C “” is optional. Anything entered there will be saved as a comment in the public key file (for example, id\_ed25519.pub). This comment is intended for identification purposes, which can be helpful if you use multiple keys; it is not intended for security purposes. {% endhint %} {% endstep %} {% step %} #### Specify the Key Storage Location Choose where you want to store the key files. * **To use the default path:** simply press Enter. * **To use a custom filename/path:** type the desired path/filename (e.g., `C:\Users\\.ssh\your_custom_filename`) and press Enter

Save to the default path

{% endstep %} {% step %} #### Add Passphrase The Passphrase is an additional layer of security. Adding a passphrase is the **most crucial step** for securing your Private Key. Even if someone obtains your Private Key file, they will not be able to use it without this passphrase. Type your passphrase and press Enter. Type the same passphrase again to confirm and press Enter.
{% hint style="info" %} **Note**: * The passphrase you type will **not be visible** on the screen for security reasons. * **Leaving it empty** (just pressing Enter) means your key will not have passphrase protection. {% endhint %} {% endstep %} {% step %} #### SSH key is created Upon successful completion, the system will confirm that your SSH key pair has been saved and is ready for use.
{% hint style="info" %} The key comes in pairs: * id\_ed25519: your **private key** Keep it safe, never share. You will need this key to access the rented instance via the terminal applications. * id\_ed25519.pub: your **public key** Safe to share. You will add this key to your Pictor account (before creating the instance). {% endhint %} {% endstep %} {% endstepper %} *** ## Add SSH key to Pictor account Your SSH key generation process created two files in the location you specified. * **Private Key:** `id_ed25519` (Keep this file private and secure.) * **Public Key:** `id_ed25519.pub` (This is the key you need to add to your Pictor account) Before you can create and connect to your rented GPU instance, you must add your Public SSH Key to your Pictor account. This key acts as your secure credential for authentication. {% stepper %} {% step %} #### Open the Terminal Open a Terminal application on your machine. For example, use PowerShell or Command Prompt on Windows, Terminal.app on macOS, or a Terminal Emulator (like Gnome Terminal or Konsole) on Linux. {% endstep %} {% step %} #### Run the command * On Windows PowerShell, assuming `C:\Users\\.ssh\id_ed25519.pub` is your public key filepath, enter: ```powershell cat C:\Users\\.ssh\id_ed25519.pub ``` * On Windows Command Prompt, assuming `C:\Users\\.ssh\id_ed25519.pub` is your public key filepath, enter: ```cmd type C:\Users\\.ssh\id_ed25519.pub ``` * On macOS Terminal.app, assuming `id_ed25519.pub` is your public key file, enter: ```bash cat ~/.ssh/id_ed25519.pub ``` {% endstep %} {% step %} #### Get the public key The terminal will display the entire Public Key as a line of text. **Copy this entire output**, starting with `ssh-ed25519` and including the comment at the end (`hana@pictor.network` here, for example)
{% endstep %} {% step %} #### Add the key to your Pictor account * Go to [app.pictor.network](https://app.pictor.network/) >> Navigate to **GPU Renting** page on the sidebar >> Under the **Instances** tab, choose **Manage SSH Keys** button.
* Click Add **New SSH Key** >> enter your **Key Name** and paste your **Public Key** >> Click **Create SSH Key**.
* Your SSH key is added successfully and is ready to be selected when you [create an Instance on Pictor](https://docs.pictor.network/docs/services/gpu-renting/get-started#step-3-create-an-instance). {% endstep %} {% endstepper %} *** ## Review SSH keys To maintain account security, you should regularly review your SSH keys list and delete any keys that are no longer valid (or may be compromised). **How to review your SSH keys:** 1. Go to [app.pictor.network](https://app.pictor.network/) 2. Navigate to **GPU Renting** page on the sidebar >> **Manage SSH Keys** 3. Click the **View** button on each key to review its details, such as: * Created time * Public key * Machines currently connected using this SSH key **Delete SSH key:** You should delete SSH keys if you don't recognize them, if the keys are outdated, or if they may have been compromised. To delete a key, simply click the **Delete** button next to it.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.pictor.network/docs/services/gpu-renting/connection-methods/ssh.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.