SSH troubleshooting

This article aims to help you finding common issues establishing an SSH connection on fortrabbit.

Common reasons and solutions

$ ssh {{ssh-user}}@deploy.{{region}}.frbit.com
# Some error here!

Can't login by SSH? Here are some common issues users often run into.

SSH public key issues

If you have trouble setting up a connection, using SSH public keys as your authentication method - especially when you are doing this for the first time - see our SSH key troubleshooting guide first. This is common source of issues.

Host authenticity warning

The first time you are connecting to fortrabbit service via SSH, there will be a warning about connection to a new SSH server. Just type yes, which will record the fingerprint of the fortrabbit deploy service into the ~/.ssh/known_hosts file. If this fingerprint changes in the future, then you will se an error about that and will have to take further action depending on the situation.

The authenticity of host '…' can't be established
RSA key fingerprint is …
Are you sure you want to continue connecting (yes/no)?

In some edge cases (special environments like Git bash), you will have to manually define where the known-hosts file is.

General connection errors

If you can't establish a connection at all, or if it takes "forever" to connect and nothing actually happens a few things may be the cause.

  • a firewall on your end blocking outgoing connections (not very likely)
  • your IP has been quarantined by our service due to too many failed attempts (possible)

Try to figure out if you can connect to external services on port 22 from your network. Try disabling your (corporate) VPN connection, if any. If the issue persists, contact our support and describe your situation in detail.

Use verbose mode to determine what's going on

Connect to your App with the -v (verbose) flag enabled. The output from this command is useful for troubleshooting issues.

For example, this is an unsuccessful attempt because none of the keys were accepted and the server is asking for a password, which will always fail because password authentication is disabled if you are using ssh-key authentication for your fortrabbit Account.

$ ssh {{app-name}}@deploy.{{region}}.frbit.com -v

Internal error I01 after an App is created

If the App was recently created, please wait about 5 minutes for it to become ready. Trying to connect (git, ssh, sftp) before the App is ready produces an error like shown below.

A B O R T E D
  !! Internal error I01 - please try again later.
Connection to deploy.eu2.frbit.com closed.

If more than 10 minutes have passed and you still get a similar error (despite successful authentication), then please contact us via the support chat.

Further reading

Craft CMS

Install guides

Develop & deploy

Teamwork

Platform

Troubleshooting

Stacks

Tips & tricks

Need individual help?
Learn about Company plans ›
Looking for an old article?
See the full list of articles ›
Found an error?
Contribute on GitHub ›