Introduction

One of the key things required when developing with Magento is SSH access. Fortunatley MDOQ allows you to configure keys for all users in your team. As well as add one off ones for third parties if required.

If you don't have an ssh key checkout generating an ssh key

Setup default SSH Keys

1. Select your live connector / production instance
2. Navigate to "Settings" > "SSH"
3. Click to "Enable" ssh
4. You can then add as many ssh keys are you want under "Identities"
   Each identity requires a name and the public part of your ssh key
5. Click "Save"
   That's it, all future instance will have these keys added.

Setup SSH Keys For An Existing Instance

If you already have an instance and you want to add ssh keys to there are a couple of options.

Using Keys From The Parent Instance

If you already created the instance before configuring SSH keys on the parent instance, you can still pull them into your instance.

1. Select your instance.
2. Check "SSH"
3. Click "Proceed"
   MDOQ will then recreate all the need components to add the configured SSH keys to the instance.

Specific Keys For An Instance

If you would like to add ssh keys just for a single instance. Maybe to give a third party access to only that instance.

1. Select the instance
2. Select "Settings" > "SSH"
3. Uncheck "Inherit from live" for identities.
4. You can then update the ssh keys as you wish.
5. When finished click "Save".

MDOQ will recognise that SSH settings have changed and recreate all the need components to add the configured SSH keys to the instance.

Keys For Production

This works the same as specifying keys for a specific instance, though you will need to manually sync the SSH component after adding your keys as MDOQ won't automatically sync components for production.

SSH Access

Once you have set up keys and they are applied to your instance you can then connect to it. There are two options for this.

Web SSh

1. Select the instance
2. Select "Support"
3. Select "Web SSH"
4. Use the "choose file" input to select your private key.
5. Click connect.

CLI SSH

1. Select the instance
2. Select "Settings" > "SSH"
3. At the bottom of the SSH settings you will see two fields "Host" and "Username"
   The host field will be in the format HOST:PORT
   This will allow you to connect with:
   ssh -p PORT -i PATH_TO_PRIVATE_KEY USERSER@HOST
   An example of this may be:
   ssh -p 11111 -i ~/.ssh/id_rsa magento@www-mysite-com-1111.02.mdoq.io