545

How do I change the key pair for my ec2 instance in AWS management console? I can stop the instance, I can create new key pair, but I don't see any link to modify the instance's key pair.

2
  • 3
    I followed the steps indicated in this video and it worked youtube.com/watch?v=OF2AOekW4IE Commented Apr 20, 2018 at 16:46
  • 1
    It seems it is not possible, also one can delete key-pair from AWS and in this case host m/c can't login into EC2 instances. Looks like it is defect
    – Shailesh
    Commented Feb 21, 2021 at 12:32

23 Answers 23

626
Answer recommended by AWS Collective

This answer is useful in the case you no longer have SSH access to the existing server (i.e. you lost your private key).

If you still have SSH access, please use one of the answers below.

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#replacing-lost-key-pair

Here is what I did, thanks to Eric Hammond's blog post:

  1. Stop the running EC2 instance
  2. Detach its /dev/xvda1 volume (let's call it volume A) - see here
  3. Start new t1.micro EC2 instance, using my new key pair. Make sure you create it in the same subnet, otherwise you will have to terminate the instance and create it again. - see here
  4. Attach volume A to the new micro instance, as /dev/xvdf (or /dev/sdf)
  5. SSH to the new micro instance and mount volume A to /mnt/tmp
$ sudo mkdir /mnt/tmp; sudo mount /dev/xvdf1 /mnt/tmp
  1. Copy ~/.ssh/authorized_keys to /mnt/tmp/home/ubuntu/.ssh/authorized_keys
  2. Logout
  3. Terminate micro instance
  4. Detach volume A from it
  5. Attach volume A back to the main instance as /dev/xvda
  6. Start the main instance
  7. Login as before, using your new .pem file

That's it.

30
  • 13
    just saved my ass, you're a legend! Commented May 9, 2013 at 21:17
  • 10
    mkdir /mnt/tmp and then mount /dev/xvdf /mnt/tmp should do the trick for #5. And don't forget step 13. is probably rm ~/.ssh/known_hosts on boxes you've been connecting from. Commented Apr 9, 2014 at 6:38
  • 26
    This is so smelly… First of all, see the answer by Eric Hammond below. Second: answer by Pat Mcb. They perform actually the same thing but without wasting 1h of your time on doing the hilarious workaround. PS. See also stackoverflow.com/a/24143976/547223
    – kgadek
    Commented Dec 9, 2014 at 22:46
  • 7
    I wrote really specific instructions here that build on this answer but is essentially the same idea - gist.github.com/tamoyal/1b7ec4d3871b343d353d. As @kgadek noted, it's a bit dirty and time consuming but it's a great option if you are locked out of the server you want to make the key change on and if you don't want to spin up a copy of that server. It takes about 5-10 minutes per instance, not an hour.
    – Tony
    Commented May 25, 2015 at 18:53
  • 7
    Answers posted by @Eric and @Pat are solutions to people who just want to use a different key pair for their instances. These doesn't help an user who somehow has lost the key pair file in the first place. Without detaching the volume and attaching it to another instance how would you gain control on that volume? Let alone replacing the original .ssh/authorized_keys file.
    – sanjeev
    Commented Mar 29, 2018 at 9:40
216

Once an instance has been started, there is no way to change the keypair associated with the instance at a meta data level, but you can change what ssh key you use to connect to the instance.

There is a startup process on most AMIs that downloads the public ssh key and installs it in a .ssh/authorized_keys file so that you can ssh in as that user using the corresponding private ssh key.

If you want to change what ssh key you use to access an instance, you will want to edit the authorized_keys file on the instance itself and convert to your new ssh public key.

The authorized_keys file is under the .ssh subdirectory under the home directory of the user you are logging in as. Depending on the AMI you are running, it might be in one of:

/home/ec2-user/.ssh/authorized_keys
/home/ubuntu/.ssh/authorized_keys
/root/.ssh/authorized_keys

After editing an authorized_keys file, always use a different terminal to confirm that you are able to ssh in to the instance before you disconnect from the session you are using to edit the file. You don't want to make a mistake and lock yourself out of the instance entirely.

While you're thinking about ssh keypairs on EC2, I recommend uploading your own personal ssh public key to EC2 instead of having Amazon generate the keypair for you.

Here's an article I wrote about this:

Uploading Personal ssh Keys to Amazon EC2
http://alestic.com/2010/10/ec2-ssh-keys

This would only apply to new instances you run.

11
  • 14
    aatifh: Here's an article I wrote on how to get yourself out of that situation: alestic.com/2011/02/ec2-fix-ebs-root Commented Mar 19, 2012 at 16:20
  • 2
    @StevenLu: Yep, comment threads are the wrong place to ask new questions. Try creating a new question on serverfault.com (more appropriate for that problem than stackoverflow). Commented Mar 8, 2013 at 21:50
  • 4
    Here's a nice little one-liner for adding your key. This just adds your normal pub key in addition to the AWS generated one, so if it doesn't work, you won't have locked yourself out: stackoverflow.com/a/5654728/193494
    – Kevin C.
    Commented Apr 2, 2013 at 18:58
  • 1
    @Black From the "About" page on the blog: "Unless specified, sample commands in this blog are generally tested on the latest LTS (Long Term Support) release of Ubuntu. Instructions may work on other Linux distros like Amazon Linux, Debian, or CentOS, but may also need some adaptation." Commented Jul 1, 2022 at 1:23
  • 1
    This info should be placed in the article itself. Who clicks on the about page before reading the article? The information is totaly unexpected there.
    – Black
    Commented Jul 4, 2022 at 10:18
102

Run this command after you download your AWS pem.

ssh-keygen -f YOURKEY.pem -y

Then dump the output into authorized_keys.

Or copy pem file to your AWS instance and execute following commands

chmod 600 YOURKEY.pem

and then

ssh-keygen -f YOURKEY.pem -y >> ~/.ssh/authorized_keys
7
  • 23
    This works only if you already have access to the system, right? (like not lost the old .pem file).
    – Daniel
    Commented Jun 22, 2015 at 5:18
  • 8
    You can use > instead of >> to override the current user instead of add it. Commented Jul 26, 2016 at 4:52
  • 3
    This is the correct and simplest answer. No need to restart, create new instances, or mount drives. Just get the .pem, keygen it and add it to authorized_hosts.
    – Spanky
    Commented Nov 29, 2016 at 20:50
  • i have done this ssh-keygen -f YOURKEY.pem -y >> ~/.ssh/authorized_keys but sitll can't access my ec2 with the new pubic key. Commented Aug 29, 2017 at 14:08
  • I ran this and my local key didn't changed.
    – Luiz
    Commented Nov 13, 2017 at 20:58
70

Instruction from AWS EC2 support:

  1. Change pem login
  2. go to your EC2 Console
  3. Under NETWORK & SECURITY, click on Key Pair Click on Create Key Pair
  4. Give your new key pair a name, save the .pem file. The name of the key pair will be used to connect to your instance
  5. Create SSH connection to your instance and keep it open
  6. in PuttyGen, click "Load" to load your .pem file
  7. Keep the SSH-2 RSA radio button checked. Click on "Save private key" You'll get pop-up window warning, click "Yes”
  8. click on "Save public key" as well, so to generate the public key. This is the public key that we're going to copy across to your current instance
  9. Save the public key with the new key pair name and with the extension .pub
  10. Open the public key content in a notepad
  11. copy the content below "Comment: "imported-openssh-key" and before "---- END SSH2 PUBLIC KEY ----
    Note - you need to copy the content as one line - delete all new lines
  12. on your connected instance, open your authorized_keys file using the tool vi. Run the following command: vi .ssh/authorized_keys you should see the original public key in the file also
  13. move your cursor on the file to the end of your first public key content :type "i" for insert
  14. on the new line, type "ssh-rsa" and add a space before you paste the content of the public key , space, and the name of the .pem file (without the .pem) Note - you should get a line with the same format as the previous line
  15. press the Esc key, and then type :wq!

this will save the updated authorized_keys file

now try open a new SSH session to your instance using your new key pai

When you've confirmed you're able to SSH into the instance using the new key pair, u can vi .ssh/authorized_key and delete the old key.

Answer to Shaggie remark:

If you are unable to connect to the instance (e.g. key is corrupted) than use the AWS console to detach the volume (http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-detaching-volume.html) and reattach it to working instance, than change the key on the volume and reattach it back to the previous instance.

8
  • 7
    Should be the best answer
    – user985818
    Commented Aug 24, 2016 at 1:06
  • 3
    What if old key has got corrupted and you are unable to connect to instance via putty as you dont have the old ppk file???
    – Shaggie
    Commented Mar 18, 2017 at 10:09
  • 9
    what if you don't have SSH access, hence this problem. Commented Aug 31, 2017 at 4:05
  • 3
    Jayden Lawson, what if you don't have internet connection?
    – Elia Weiss
    Commented Sep 1, 2017 at 5:09
  • 2
    It may happen that key-pair shared with other person and now need to change key-pairs so that person can't log in anymore, Or many other reasons like this, Commented Nov 26, 2018 at 11:59
48

I noticed that when managed by Elastic Beanstalk, you can change your active EC2 key pair. Under Elastic Beanstalk > Configuration > Security, choose the new key from the EC2 key pair drop-down. You'll see this message asking if you're sure:

EC2KeyName: Changes to option EC2KeyName settings will not take effect immediately. Each of your existing EC2 instances will be replaced and your new settings will take effect then.

My instance was already terminated when I did this. It then started, terminated, and started again. Apparently "replacing" means terminating and creating a new instance. If you've modified your boot volume, create an AMI first, then specify that AMI in the same Elastic Beanstalk > Configuration > Instances form as the Custom AMI ID. This also warns about replacing the EC2 instances.

After you've modified your EC2 key pair and Custom AMI ID, and after seeing warnings about both, click Save to continue.

Remember that the IP address changes when the instance is re-created so you'll need to retrieve a new IP address from the EC2 console to use when connecting via SSH.

2
  • 2
    This is now under the 'Security' section of the config. Commented Mar 29, 2018 at 15:38
  • Thanks @WillDemaine. Not using AWS currently so I'll take your word for it and approve the edit!
    – Mark Berry
    Commented Mar 29, 2018 at 15:56
37

I went through this approach, and after some time, was able to make it work. The lack of actual commands made it tough, but I figured it out. HOWEVER - much easier approach was found and tested shortly after:

  1. Save your instance as an AMI (reboot or not, I suggest reboot). This will only work if EBS backed.
  2. Then, simply start an instance from this AMI and assign your new Keyfile.
  3. Move over your elastic IP (if applicable) to your new instance, and you are done.
5
  • This totally worked for me after I accidentally deleted ~/.ssh
    – morri
    Commented Dec 24, 2013 at 17:10
  • I did the same and it worked, now I can login with new pem. But I still can login with the old pem. So now 2 pems are valid.
    – Vitaly
    Commented Sep 12, 2014 at 21:35
  • FYI this is a quick easy GUI method of spinning up a new EC2 with different key if busy but as @vitaly found you have the old pem key also valid, need to go to /home/ec2-user/.ssh/authorized_keys and remove the old pem key from the file. Thanks for the quick Pem key change method nice and easy when got no time.
    – Blu Towers
    Commented Mar 22, 2015 at 12:02
  • This didn't work for me. AWS kept saying the password was unavailable with another message mentioning that if the instance was created from an AMI it uses the parent image's credentials.
    – Brady
    Commented Nov 13, 2017 at 19:46
  • THIS is the best answer, as it solves the problem of losing the original PEM file. So many of the answers have a step of "log on with your old pem file" .... how do you do that if you lost it? (we have a sysadmin who departed with a personal issue, and his supervisor had, but lost, the private key)
    – J. Gwinner
    Commented Jan 10, 2023 at 1:55
33

Steps:

  1. Create new key e.g. using AWS console, the PuTTY Key Generator, or ssh-keygen
  2. Stop instance
  3. Set instance user data to push public key to server
  4. Start instance

enter image description here

#cloud-config
cloud_final_modules:
- [once]
bootcmd:
 - echo 'ssh-rsa AAAAB3Nz...' > /home/USERNAME/.ssh/authorized_keys

Where USERNAME is the expected username for the machine. A listed of default usernames is available from AWS.

Step-by-step instructions from AWS

3
27

There are two scenarios asked in this question:-

1)You don't have access to the .pem file that's why you want to create a new one.

2)You have the .pem file access with you but you just want to change or create a new .pem file for some vulnerability or security purposes.

So if you lost your keys you can scroll up and see other answers. But if you just simply change your .pem file for security purposes follow the steps:-

1)Go to AWS console login and create a new .pem file from the key-pair section over there. It will automatically downloaded .pem file into your pc

2)change permission to 400 if you are using Linux/ubuntu hit the below command

chmod 400 yournewfile.pem

3)Generate RSA of the newly-downloaded file in your local machine

ssh-keygen -f yournewfile.pem -y

4)Copy the RSA code from here

5)Now SSH to your instance via previous .pem file

ssh -i oldpemfileName.pem username@ipaddress

sudo vim  ~/.ssh/authorized_keys

6)Give one-two lines space and paste the copied RSA of new file here and then save the file

7)Now your new .pem file is linked with the running instance

8)If you want to disable the previous .pem file access then just edit the

sudo vim ~/.ssh/authorized_keys

file and remove or change the previous RSA from here.

Note:- Remove carefully so that newly created RSA not get changed.

In this way, you can change/connect the new .pem file with your running instance.

You can revoke access to previously generated .pem file due to security purposes.

Hope it would help!

4
  • 3
    I kinda like this solution because it doesn't require me to create new instance with frozen AMI image. But is this method able to change the associated keypair-name of the EC2 instance in the EC2 dashboard? @Parveen yadav
    – addicted
    Commented Apr 9, 2020 at 9:35
  • Its really amazing answer, I want to add only one thing you can generate RSA using Putty generator also
    – sunil
    Commented Jul 22, 2020 at 10:01
  • Ec2 dashboard still shows the old key pair name. Since this was not changed from the console
    – tnishada
    Commented Oct 30, 2020 at 11:25
  • You made it simple. Best explained.
    – Ankur Garg
    Commented Sep 26, 2022 at 5:54
19

I believe the simpliest aproach is to :

  1. Create AMI image of existing instance.
  2. Launch new EC2 instance using AMI image (crated by step 1) with new key pair.
  3. Login to new EC2 instance with new key.
3
  • @Brady , what does not work at all? making a snapshot? launching instance? login?
    – Sergey
    Commented Nov 15, 2017 at 7:39
  • 5
    I'm not sure if this change is a recent one or not, but when you create an AMI from an instance that already has a key assigned you need to have that key available to log into the copied AMI image, regardless of whether or not you assign a different key pair during creation.
    – Brady
    Commented Nov 16, 2017 at 18:23
  • 1
    This is not a solution, as @Brady mentions it does not work. Commented Feb 23, 2018 at 0:59
18

If below steps are followed it will save lot of time and there will be no need to stop the running instance.

  1. Start new t1.micro EC2 instance, using new key pair. Make sure you create it in the same subnet, otherwise you will have to terminate the instance and create it again.
  2. SSH to the new micro instance and copy content of ~/.ssh/authorized_keys somewhere on your computer.
  3. Login to main instance with old ssh key.
  4. Copy & replace the file content from point 2 to ~/.ssh/authorized_keys
  5. Now you can login again only with new key. Old key will not work anymore.

That is it. Enjoy :)

1
  • 1
    instinctive solution!
    – Shuduo
    Commented Apr 1 at 15:20
10

In case you are using ElasticBeanstalk platform, you can change the keys by going:

  • Elastic Beanstalk panel
  • Configuration
  • Instances (cog top-right)
  • EC2 key pair

This will terminate current instance and creates new one with chosen keys/settings.

2
  • 2
    This is hands down the simplest answer here, provided you're on ElasticBeanstalk. Commented Jul 14, 2016 at 16:46
  • 2
    Warning ! This is a dangerous solution. The AWS will also reset the storage (i.e. Virtual HDD) attached to that instance (!!). So, you have to detach the storage, and, after raising a new instance, reattach it again instead of the new one that came with the new instance. Of-course, it'll be best is it's not an encrypted volume (and you haven't lost its key..)
    – JamesC
    Commented Nov 19, 2017 at 11:00
10

The simplest solution is to copy the contents of

~/.ssh/id_rsa.pub

into your AWS instance's authorized_keys at

~/.ssh/authorized_keys

This will allow you to ssh into the EC2 instance without specifying a pem file for the ssh command. You can remove all other keys once you've tested connecting to it.

If you need to create a new key to share it with someone else, you can do that with:

ssh-keygen -t rsa

which will create the private key.pem file, and you can get the public key of that with:

ssh-keygen -f private_key.pem -y > public_key.pub

Anyone who has private_key.pem will be able to connect with

ssh [email protected] -i private_key.pem
2
  • 6
    how can I access ~/.ssh/authorized_keys when I can't even SSH aws instance? Commented Apr 3, 2017 at 9:21
  • 3
    I believe your last line is incorrect, you will be able to connect only if you have the private key.. ssh -i private_key.pem [email protected]. If you want someone to give you access to their instance you can safely share your public key with them and they can add it to their authorized_keys to grant you access to the instance as that user...
    – code4cause
    Commented Oct 5, 2017 at 14:25
6

You don't need to rotate root device and change the SSH Public Key in authorized_keys. For that can utilize userdata to add you ssh keys to any instance. For that first you need to create a new KeyPair using AWS console or through ssh-keygen.

ssh-keygen -f YOURKEY.pem -y

This will generate public key for your new SSH KeyPair, copy this public key and use it in below script.

Content-Type: multipart/mixed; boundary="//"
MIME-Version: 1.0

--//
Content-Type: text/cloud-config; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="cloud-config.txt"

#cloud-config
cloud_final_modules:
- [scripts-user, always]

--//
Content-Type: text/x-shellscript; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="userdata.txt"

#!/bin/bash
/bin/echo "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6xigPPA/BAjDPJFflqNuJt5QY5IBeBwkVoow/uBJ8Rorke/GT4KMHJ3Ap2HjsvjYrkQaKANFDfqrizCmb5PfAovUjojvU1M8jYcjkwPG6hIcAXrD5yXdNcZkE7hGK4qf2BRY57E3s25Ay3zKjvdMaTplbJ4yfM0UAccmhKw/SmH0osFhkvQp/wVDzo0PyLErnuLQ5UoMAIYI6TUpOjmTOX9OI/k/zUHOKjHNJ1cFBdpnLTLdsUbvIJbmJ6oxjSrOSTuc5mk7M8HHOJQ9JITGb5LvJgJ9Bcd8gayTXo58BukbkwAX7WsqCmac4OXMNoMOpZ1Cj6BVOOjhluOgYZbLr" >> /home/hardeep/.ssh/authorized_keys
--//

After the restart the machine will be having the specified SSH publch key. Remove the userdata after first restart. Read more about userdata on startup.

3

I have tried below steps and it worked without stopping the instance. My requirement was - as I have changed my client machine, the old .pem file was not allowing me to log in to the ec2 instance.

  1. Log in to the ec2 instance using your old .pem file from the old machine. Open ~/.ssh/authorized_keys

You will see your old keys in that file.

  1. ssh-keygen -f YOUR_PEM_FILE.pem -y It will generate a key. Append the key to ~/.ssh/authorized_keys opened in step#1. No need to delete the old key.

  2. From AWS console, create a new key pair. Store it in your new machine. Rename it to the old pem file - reason is old pem file is still associated with the ec2 instance in AWS.

All done.

I am able to log in to the AWS ec2 from my new client machine.

3

You have several options to replace the key of your EC2 instance.

  1. You can replace the key manually in the .ssh/authorized_keys file. However this requires you to have actually access to the instance or the volume if this is unencrypted.
  2. You can use the AWS Systems Manager. This requires to have an agent installed.

Since the first option can be found easily in the answers or at the search engine of your choice, I want to focus on the Systems Manager.

  1. Open the Service Systems Manager
  2. Click on Automation on the left side.
  3. Click on Execute Automation
  4. Select AWSSupport-TroubleshootSSH (usually it is on the last page)

You can find more information on the Official AWS Documentation

3

Thanks for the tips guys. Will definitely keep them in mind when I need to rest the key pairs. However, in the interest of efficiency and laziness I've come up with something else:

  1. Create your new key pair and download the credentials
  2. Right-click your instance > Create AMI Once it is done
  3. terminate your instance (or just stop it until you are sure you can create another one from your new shiny AMI)
  4. Start a new EC2 instance from the AMI you just created and specify your new key pair created in step (1) above.

Hope this can be of use to you and save you some time as well as minimize the amount of white hair you get from stuff like this :)

2
  • why I would terminate my instance. I only need to change my key pair?
    – Sisir
    Commented Sep 1, 2020 at 20:00
  • It's may not a good idea. Creating a new AMI and running a new instance may face another problem like volume speed down. Commented Sep 13, 2021 at 5:23
2

What you can do...

  1. Create a new Instance Profile / Role that has the AmazonEC2RoleForSSM policy attached.

  2. Attach this Instance Profile to the instance.

  3. Use SSM Session Manager to login to the instance.
  4. Use keygen on your local machine to create a key pair.
  5. Push the public part of that key onto the instance using your SSM session.
  6. Profit.
1
2

This is for them who has two different pem file and for any security purpose want to discard one of the two. Let's say we want to discard 1.pem

  1. Connect with server 2 and copy ssh key from ~/.ssh/authorized_keys
  2. Connect with server 1 in another terminal and paste the key in ~/.ssh/authorized_keys. You will have now two public ssh key here
  3. Now, just for your confidence, try to connect with server 1 with 2.pem. You will be able to connect server 1 with both 1.pem and 2.pem
  4. Now, comment the 1.pem ssh and connect using ssh -i 2.pem user@server1
1

Yegor256's answer worked for me, but I thought I would just add some comments to help out those who are not so good at mounting drives(like me!):

Amazon gives you a choice of what you want to name the volume when you attach it. You have use a name in the range from /dev/sda - /dev/sdp The newer versions of Ubuntu will then rename what you put in there to /dev/xvd(x) or something to that effect.

So for me, I chose /dev/sdp as name the mount name in AWS, then I logged into the server, and discovered that Ubuntu had renamed my volume to /dev/xvdp1). I then had to mount the drive - for me I had to do it like this:

mount -t ext4 xvdp1 /mnt/tmp

After jumping through all those hoops I could access my files at /mnt/tmp

1
  • as a comment this should be added as a comment, not an answer.
    – JDL
    Commented Oct 5, 2016 at 15:42
1

If anybody is here because they can't access an EC2 instance because they don't have the keypair, but they do have IAM access, you can run the following command to allow temporary access (60 seconds) to your EC2 instance using a key you already have, as long as you know the username (which is usually 'ubuntu' for ubuntu instances or 'ec2-user' for amazon linux instances):

aws ec2-instance-connect send-ssh-public-key --region ${your-aws-region} --instance-id ${your-instance-id} --availability-zone ${your-instance-az} --instance-os-user ${username} --ssh-public-key file://path/to/public/key 

(If you have multiple credentials profiles in your ~/.aws/credentials file you can specify by also adding the flag '--profile your-profile' to this command)

The output will look something like this if successful:

{
"RequestId": "3537268d-c161-41bb-a4ac-977b79b2bdc0",
"Success": true
}

Then you have 60 seconds to ssh in using that key.

1
  • 1
    This absolutely saved my hide. Thanks! The availability-zone param wasn't needed in my case fwiw Commented Oct 4, 2023 at 18:00
0

This will work only if you have access to the instance you want to change/add the key in. You can create a new key pair. Or if you already have the key pair, then you can paste the public key of the new pair in the authorized_keys file on your instance.

vim .ssh/authorized_keys

Now you can use the private key for that pair and log in.

Hope this helps.

0

if you are unable to login in VM and deleted your ssh key's and you can also change the key pair of your ec2 using below steps. Go step by step 1) stop your ec2 instance. 2)take a snapshot of VM and storage. 3)create a new VM while creating it select your snapshot and create VM from your Snapshot. 4) while the creation of VM downloads your keypair. 5) once your VM UP you can ssh with a new key pair and your data will also back.

0

Alternate solution. If you have the only access on server. In that case don't remove pem file from AWS console. Just remove pem access key from sudo nano ~/.ssh/authroized_keys and add your system public ssh key. Now you have the access ssh [email protected]

Not the answer you're looking for? Browse other questions tagged or ask your own question.