***

title: Install Postman Insights Agent on EC2
updated: 2025-05-30T00:00:00.000Z
max-toc-depth: 2
----------------

The Postman Insights Agent listens to the traffic arriving at the service you want to monitor and automatically populates your Insights project with endpoints.

To use the Insights Agent with a standalone Linux instance of Amazon EC2, complete the following steps.

<Info class="iconless-callout">
  **Estimated time:** 10-minute setup, 5-minute wait
</Info>

After onboarding a service, you'll see your endpoints and their insights. Then, you can leverage the Insights' [Repro Mode](#activate-repro-mode) to debug your failing endpoints. You can also set up [alerts](#set-up-alerts) to get notifications about your errors.

## Requirements

* SSH access to your virtual EC2 machine.
* Your server's OS supports `systemd`.
* Root user privileges in order to edit `systemd` files.
* **Insights project.** See [Get started with Postman Insights](/docs/insights/get-started/overview/) to learn more.

## Install Insights Agent on EC2

To install the Insights Agent, do the following:

1. From the **Setup** tab of your workspace, select **Start with EC2**.

   <img alt="Select your environment" src="https://assets.postman.com/postman-docs/v11/insights-environment-select-v.11.45.jpg" />

2. Log in to the EC2 instance. For more information, see [Connect to your EC2 Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect.html).

3. As shown on the Insights onboarding screen, run the install script on that instance.

   ```bash
   bash -c "$(curl -L https://releases.observability.postman.com/scripts/install-postman-insights-agent.sh)"
   ```

4. On the Insights onboarding screen, click **Add API key** to copy and paste it with the next command.

   <Info class="iconless-callout">
     In the example command below, the angle brackets and the text between them are placeholders. The command you copy in the onboarding screen will contain your correct API key and project ID.
   </Info>

   ```bash
   sudo POSTMAN_API_KEY=<your-api-key> postman-insights-agent ec2 setup --project <projectId> --repro-mode
   ```

   <Info class="iconless-callout">
     The `--repro-mode` flag allows the agent to send encrypted payload data for rerunning requests.
   </Info>

   In the resulting output, the server checks for user permissions and the presence of `systemd`, configures `systemd` files, and enables Postman Insights Agent as a `systemd` service.

5. Check the status or logs. Run the `journalctl` command:

   ```bash
   sudo journalctl -fu postman-insights-agent
   ```

6. In Postman, check out the Insight Project's **Endpoints** tab to see the list of endpoints the Insights Agent generates as it gathers data.

Run the `help` command for other configuration parameters.

```bash
postman-insights-agent ec2 --help
```

<Info class="iconless-callout">
  **Tip:** If you're not seeing your endpoints right away, traffic may be taking some time to collect. See the next section for more information.
</Info>

## Wait for the Insights Agent to collect traffic

After Insights detects traffic from the Insights Agent, you'll get automatically redirected to the **Overview** page. The Insights Agent needs 5-8 minutes to use AI to generate endpoints.

If you're only seeing health checks, your traffic may be affected. If you're not seeing what you expect after 10 minutes, see [Diagnose and troubleshoot Insights Agent errors](/docs/insights/troubleshoot/overview/).

## Activate Repro Mode

<Info class="iconless-callout">
  Only a Workspace Admin can enable the **Repro Mode**.
</Info>

To make API calls using real user data, you need to activate Repro Mode. Go to your Insights project and click [**Settings**](/docs/insights/reference/app/settings-tab/). Then, toggle on **Activate Repro Mode**.

<Info class="iconless-callout">
  **Default data redactions.** Postman Insights automatically redacts a set of sensitive values including authentication tokens. See the [full list](/docs/insights/data/redactions/). You can also add fields to redact ahead of turning on the feature.
</Info>

Learn more about [debugging with Repro Mode](/docs/insights/debug/).

## Set up alerts

Insights alerts notify you about your errors in real time, so you can act on them immediately. In your Insights project's **Alerts** tab, you can adjust error rate thresholds, find and view problematic endpoints, mute or unmute alerts globally for specific endpoints, and integrate your alerts with Slack. Learn more about [configuring and using alerts](/docs/insights/reference/app/alerts-tab/).