Integration with AWS

Overview

This integration securely imports EC2 and Lightsail servers into a group in Termius that automatically updates to reflect the changes in your AWS environment. When you add or remove a server in AWS, or change a server's details, the host entry in Termius will appear, disappear, or update accordingly.

Configure AWS access

To connect Termius to your AWS cloud, you need an IAM user with programmatic access and read-only permissions, the access key ID and secret access key generated for that user. Termius will use it to access information about your AWS environment.

The access keys you enter in Termius are stored locally and are not synced across devices.

Add an IAM user in AWS

1. Sign in to the AWS Management Console and open the IAM console

2. In the navigation pane, select IAM users

   
3. Click Create user in the top right corner

   
4. Provide a user name and click Next

   
5. On the Set permissions page, select Attach policies directly

   
6. In the search box, type ReadOnlyAccess and select the ReadOnlyAccess (AWS managed - job function) policy from the results. Click Next

   
7. Click Create user

   

Generate an access key

1. In the IAM Users list, select the user you've just created

   
2. Open the Security credentials tab

   
3. Scroll to the Access keys section and click Create access key

   
4. Choose Other and click Next

   
5. Optionally add a description tag, then click Create access key

6. Copy or download the Access key ID and Secret access key immediately. AWS will not display it again for security purposes. You'll paste it into Termius

   

Your IAM user is now set up and Termius can load information about your servers.

Enable AWS integration in Termius

1. On the Hosts screen, click the chevron next to the New Host button and select AWS Integration

   
2. In the Label field, enter a name for the group

   
3. In the Region field, specify your AWS region (e.g. us-east-2)

   
4. Paste the credentials from your AWS into the corresponding fields:

   • Access key → Access Key ID

   • Secret access key → Secret access key

   
5. Select whether you want to import EC2 or Lightsail servers

6. Select the type of IP addresses you want to be imported

7. (Optional) You can configure additional SSH settings for the group, such as port or credentials. Click Add protocols below the Cloud sync settings, and fill out the required fields. For more details, see Groups and tags

   
8. Termius automatically saves the group and begins importing your servers