(Optional) Configure a Proxy

Learn how to configure an http or https proxy if your device needs to connect to the internet through a proxy server.

Enable a proxy using a manual script

Note: This process only applies when using MSI version 2.3.3 (released May 8, 2025) or later.

1. To configure a proxy, you need to run a manual script:
   • Script name: edge-install.ps1
   • Runtime: PowerShell
   • Requirements: Data connector already installed (msi)

   When running the installation script, use the following example command, specifying the ProxyUrl as explained:

    edge-install.ps1 -ProxyEnabled "true" -ProxyUrl "https://x.x.x.x:1234"

   This command configures the installer to connect to the internet through the specified proxy.

   The -ProxyUrl parameter specifies the address of the proxy server and should be formatted as follows: <scheme>://<hostname>:<port>

   • <scheme> is http or https
   • <hostname> is the address of the proxy server (for example, proxy.example.com)
   • <port> is the port number used to connect (for example, 8080)

   You can also refer to this parameter explanation in the Amazon documentation.

   Note: If the proxy was configured before and edge-install is used again, it will enable the proxy automatically since it remembers the previous setting.
2. To configure an https proxy, a trusted certificate is also required.

   To configure a new trusted certificate, another parameter is needed (this can be combined with the proxy command above).

   • Script name: edge-install.ps1
   • Runtime: PowerShell
   • Requirements: Data connector already installed (msi)

   To enable a proxy certificate, use the following example command:

   edge-install.ps1 -ProxyCertFilePath "C:\Users\<Username>\Desktop\exampleCertificate.pem"

   The -ProxyCertFilePath specifies the path to the certificate file. Specify the appropriate path for your certificate. See below for how to obtain a certificate.

   If you want, you can complete steps 1 and 2 for an https proxy at the same time by running the command:

   edge-install.ps1 -ProxyCertFilePath "C:\Users\<Username>\Desktop\exampleCertificate.pem" -ProxyEnabled "true" -ProxyUrl " https://x.x.x.x:1234"

   Note: If the https proxy certificate was configured before and edge-install is used again, it will enable the certificate automatically since it remembers the previous setting too.

3. If you need to disable the http/https proxy, you can use the following command:

   edge-install.ps1 -ProxyEnabled "false" -ProxyCertFilePath ""

Obtain a certificate from a website

These steps should be run from a computer where:

• Network traffic is routed through a proxy
• A proxy certificate is installed on the machine and is being used by Chrome

Note: Be sure to select the proxy certificate (check the name from the details page).

1. Use a machine that:
   • Is already configured to use a proxy
   • Has the proxy certificate installed
   • Has Chrome installed and Chrome is using the certificate
2. Open Chrome.
3. Visit a website that is not blocked by proxy.
4. Open the website connection details panel. This is the small button at the left-most side of the URL bar (at the top of Chrome).
5. Click on the "connection is secure" option.
6. Click on the "certificate is valid" option.
7. In the panel that opens:
   1. Verify the certificate is valid and matches the proxy certificate by checking the name and expiration date.
   2. Click on details.
   3. Click on export on the bottom.