How to access fortrabbit services

So far so good: You are using your Account e-mail address and your Account password to login to the fortrabbit Dashboard. Beside that, there are these interaction channels with fortrabbit services:

Interactions requiring authentication¶

• Deploying code with Git
• Using SSH
• Using SFTP
• Accessing the MySQL database
• Viewing log files
• Execution SSH Remote commands
• Accessing the Object Storage

Of course these operations need to be protected. We need to make sure that only you and your team have access. You can choose between two authentication methods:

Available authentication methods¶

• Password - the easy default - see below
• Public SSH key - for advanced users - see below

How to edit your access method¶

In the "Dashboard", go to "Your Account" (upper right). Under "Access method" you can find your current settings. You see which method is currently set.

SSH key authentication¶

We recommend to use public SSH key authentication to identify yourself with fortrabbit services. It's more secure than password authentication and also more convenient, once you have set it up. SSH key authentication is commonly used with services like BitBucket and GitHub.

How to add public SSH keys¶

SSH keys are stored with your Account. In the "Dashboard" > "Your Account" > "Access method" you can add and remove SSH keys.

How to create a public SSH key locally¶

We have a dedicated article on setting up and troubleshooting your local SSH keys.

GitHub SSH key import¶

Automatic import: When signing up to fortrabbit, we'll check at GitHub if there are any public SSH keys associated with your e-mail. If we find any, we'll import them and install them with your account. This is a one time setup, your SSH keys will not be synced. You can manage the SSH keys like any other keys then.

Manual import: You can also tell the import helper your GitHub account, when using different e-mail addresses here and on GitHub. There is a small link which will take you

The direct Dashboard link (login and re-authentication maybe required) will take you there directly.

App-only SSH keys¶

In certain cases you might want to add code access to an App without the need to register a new Account with fortrabbit. One case is a hectic ad-hoc hotfix scenario (good luck!), another case is that you have some advanced deployment with a third party continuous integration service bot going on. So you can install additional App-only custom public SSH keys with each App. You manage those App-only SSH keys in the Dashboard with your App.

Password authentication¶

This is the default method when no public SSH keys are installed. Use this, when you just want to check out fortrabbit or when you have trouble setting up your SSH keys locally. Hobbyists are using Password authentication. Professionals are using SSH key authentication.

How to change from password to SSH key authentication¶

In the "Dashboard" > "Your Account" > "Access method" you can add an SSH key. Once you have added your first public SSH key, password authentication will be disabled and SSH key authentication will be enabled.

How to change from SSH key to password authentication¶

When for some reason SSH key authentication does not work for you, you can downgrade to password like so: In the "Dashboard" > "Your Account" > "Access method" you can click on your public SSH keys, this will bring up a view where you can delete the key. When deleting the last key, password authentication will be re-enabled.

When you change your Account password¶

When you change your Dashboard password, for instance when you regain access to the Dashboard in case of a forgotten password, all access to the services will change as well – the new password will be used.

How it works¶

Access schema¶

URLs and terminal commands depend on your chosen access method.

# Git clone example
$ git clone [[ssh-user]]@deploy.[[region]].frbit.com:[[your-app]].git

• [[your-app]] is the name of your App (see Dashboard)
• [[region]] is eu2 or us1, depending on the location of your App

With SSH key authentication¶

• No need to enter passwords, your public key will be used
• [[ssh-user]] will be: [[your-app]]

With password authentication¶

• You will need to enter your fortrabbit Account password (each time)
• [[ssh-user]] will be: [[your-app]].[[long-user-string]]

The code example helper¶

When you are currently logged in to the Dashboard (a cookie is stored), you will see a yellow box on the right side here - with a select to choose one of your Apps. This helper knows which authentication method your Account uses. It also changes all code examples on the current page according to the selected App. So you can literary copy/paste all code examples here.

Try it out yourself

# change the values on the right and see the below change
SSH user: {{ssh-user}}
Region:   {{region}}
Your app: {{app-name}}

Authentication in teams¶

You manage your access method with your user Account on fortrabbit. This way you always have up-to-date code access on each App you own and collaborate on. It also makes managing the team easy — add/remove collaborators and code access is handled "automagically". Please mind that your team members might have a different acess method and that your settings might not work for them. Also see our team work article.

Troubleshooting¶

Authenticity error¶

The first time you are connecting to fortrabbit service via SSH, you might get an error and a prompt like this:

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

Please answer with yes. This will add our servers to the known hosts. That should be a one time setup. If you are being asked this every time you deploy, something with your known_hosts file is probably wrong. See this Stack Overflow question.

General connection errors¶

If you can't establish a connection at all, a corporate or personal firewall might be the cause. This can a protection software on your computer or something in your company. You can fix this by allowing communication on the SSH standard port: 22.

Authentication errors¶

Your local machine is maybe trying to use a different authentication method. Please check and correct your SSH configuration like so:

# terminal command to edit your ssh config file
nano ~/.ssh/config

Within this file change the preferred authentications accordingly:

# when using password authentication use:
PreferredAuthentications    password,publickey

# when using SSH key authentication use:
PreferredAuthentications    publickey,password

Problems with SSH keys¶

Please see our SSH key trouble shooting guides to resolve common problems with SSH key authentication.