# SSH Access

To use CLI commands and access the instance database you need to receive SSH access.

ReadyMage offers 2 methods of adding an SSH key to the environment:

## Using account SSH key integration (preferred way)

Using this method you will not need to copy-paste your key for each environment. It will be linked to your ReadyMage account.

### Add SSH key to your account

Navigate to **Account -> Integrations**.

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2FnqKrSfOygo8OeAl8ytkZ%2FScreenshot_20240819_172724.png?alt=media&#x26;token=c2a0e355-50b3-403e-af6e-aea0206fe1f8" alt=""><figcaption></figcaption></figure>

Click **Add Key**.

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2FubG5CobNIjX2T04AGCSv%2Fimage.png?alt=media&#x26;token=d587acc1-5407-45b3-ba5c-f91bde1422b7" alt=""><figcaption></figcaption></figure>

Enter your SSH Public Key and click **Save**.

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2FlfD0PF7aQwjnhFQhnLjT%2FScreenshot_20240816_163034.png?alt=media&#x26;token=f49f1f14-bad9-4c85-871c-f7d3ad74f0b4" alt=""><figcaption></figcaption></figure>

After saving, the SSH key will be partially visible in the integrations.

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2FCW7AGTvDR2tQk52jaKXj%2FScreenshot_20240816_161302.png?alt=media&#x26;token=d5582f36-ad36-4c15-ba38-66e3c28cbf51" alt=""><figcaption></figcaption></figure>

### Grant user access to SSH

Navigate to **User Portal → Project → Selected Instance → Application Management → SSH Access** tab. Click **Add User** and select User by email.

<figure><img src="https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2F0lDilqNivjd6xmUp7Uhk%2FScreenshot_20240819_172828.png?alt=media&#x26;token=c9e3e3da-a214-4396-b106-2c1158c447b1" alt=""><figcaption></figcaption></figure>

## Using SSH key

To do that, navigate to the **User Portal → Project → Selected Instance → Application Management → SSH Access** tab. Click **Add SSH Key**, fill in your SSH username, and add your SSH Public Key.

![](https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2F3uJPZ542ChEJZbNozlDT%2FScreenshot_20240816_162827.png?alt=media\&token=e9032f76-4649-446d-b2c4-c70d5a60e9fc)

## Connecting to the SSH server

To connect using the Terminal, copy the command by clicking on *Copy* and enter it in the terminal.

![](https://2103450200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MKew-XtJKAPabdeTxXg%2Fuploads%2F3CrnxwWFausvGIhTYLW2%2FScreenshot_20240816_162938.png?alt=media\&token=c8b5d607-934f-4669-bac0-c6ea45ac5ad9)

If you are connecting using a graphical interface you might have to add:

* Host by region:
  * USA Ohio: `ssh.ohio.us.i.readymage.com`
  * Canada Central: `ssh.central.ca.i.readymage.com`
  * Europe Ireland: `ssh.ireland.eu.i.readymage.com`
  * Europe Stockholm: `ssh.stockholm.eu.i.readymage.com`
  * Middle East UAE: `ssh.central.me.i.readymage.com`
  * Asia Pacific Sydney: `ssh.sydney.ap.i.readymage.com`
* Port - 22

You can remove users by pressing the *Delete* button next to their username.

More details on CLI, Utilities, and Tools can be found [here](https://help.readymage.com/application-management/ssh-access/ssh-usage).<br>