> For the complete documentation index, see [llms.txt](https://docs.termius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.termius.com/integrations/aws.md).
# Integration with AWS
{% hint style="info" icon="sparkle" %}
**Who can use this feature:**
* **Subscriptions:** Pro, Team, Business, and Enterprise
* **Set up:** macOS, Windows and Linux.
* **Imported hosts available:** macOS, Windows, Linux, iOS and Android
{% endhint %}
## 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.
{% hint style="success" icon="circle-info" %}
For each server, Termius imports the **DNS name** (as label), **private or public IP address** (as address), and **tags.**
{% endhint %}
### Add an IAM user in AWS
1. Sign in to the [AWS Management Console](https://console.aws.amazon.com/) and open the [IAM console](https://console.aws.amazon.com/iam/)
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.
{% hint style="info" %}
For the up-to-date instructions, see the [AWS documentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html).
{% endhint %}
## 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](/organize-and-connect-to-hosts/groups-and-tags.md)
8. Termius automatically saves the group and begins importing your servers
{% hint style="info" %}
The **access keys** you enter in Termius are stored locally and are not synced across devices.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.termius.com/integrations/aws.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.