Connecting with SSH


SSH is in early access.

You can connect to your services on Render using SSH, in addition to using the built-in shell in the dashboard.

How to connect to a service

  1. If this is your first time using SSH with a Render service, add an SSH key to your Render account.

  2. Find the service you want to connect to in the dashboard.

  3. Click the “Shell” tab.

  4. Look for the SSH command, and copy it to your clipboard. ssh command

  5. In a terminal, paste the command you copied earlier.

    ssh YOUR_SERVICE@ssh.YOUR_REGION.render.com
  6. You may see a warning like this:

    The authenticity of host 'render.com (IP_ADDRESS)' can't be established.
    ED25519 key fingerprint is (SSH_KEY_FINGERPRINT)
    Are you sure you want to continue connecting (yes/no)?

    Verify that the fingerprint in the message you see matches Render’s public key fingerprint. If it does, then type yes.


If you receive a “permission denied” message, see Troubleshooting SSH.

Render’s SSH Key Fingerprints

Public key fingerprints can be used to validate a connection to a remote server.

Render’s public SSH key fingerprints are listed below

  • SHA256:KkZPgnApmttFYSkdJsCi7B01sgZPMI6kY53MDbbanGM (Ed25519)
  • SHA256:dBRrCEA0tBkvaYLzzDw/mzaANw6nUJO961Zx806spZs (Ed25519)

Limitations

  • Services that haven’t been deployed since January 11, 2022 need to be redeployed to enable SSH.
  • SSH is not supported for free plan services, cron jobs, or static sites.
  • You can only SSH into a service that’s owned by you or a team you belong to.
  • Some Docker service configurations are not supported.
    • Dockerfiles that use, but also lock, the root account. Use usermod --unlock root or passwd -u root to unlock the account.
    • Dockerfiles that do not have user accounts set up, but specify a non-root user with the USER instruction. To SSH into these services, either create a user account with a tool like useradd or use the root (UID 0) account.

Feedback

We will continue to add features to SSH during early access. Send bug reports and feature requests to support@render.com.