> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Customizing Maia runner networking and connectivity

export const m_runner = "Maia runner";

export const maia = "Maia";

export const RunnerMetadata = ({runnerType, platforms = []}) => {
  return <div style={{
    background: 'var(--colors-background-light, #f9fafb)',
    border: '1px solid var(--colors-border-default, #e5e7eb)',
    borderRadius: '12px',
    padding: '20px 28px',
    marginBottom: '28px'
  }}>
      <table style={{
    width: '100%',
    borderCollapse: 'collapse'
  }}>
        <tbody>
          <tr>
            <td style={{
    fontWeight: '600',
    paddingRight: '32px',
    paddingBottom: '14px',
    whiteSpace: 'nowrap',
    verticalAlign: 'middle',
    width: '180px'
  }}>Runner type</td>
            <td style={{
    paddingBottom: '14px',
    verticalAlign: 'middle'
  }}>{runnerType}</td>
          </tr>
          <tr>
            <td style={{
    fontWeight: '600',
    paddingRight: '32px',
    whiteSpace: 'nowrap',
    verticalAlign: 'middle'
  }}>Runner platform</td>
            <td style={{
    verticalAlign: 'middle'
  }}>
              <div style={{
    display: 'flex',
    flexWrap: 'wrap',
    gap: '8px'
  }}>
                {platforms.map((platform, i) => <span key={i} style={{
    background: '#dcfce7',
    color: '#15803d',
    border: '1px solid #bbf7d0',
    borderRadius: '9999px',
    padding: '3px 12px',
    fontSize: '0.85rem',
    fontWeight: '500',
    whiteSpace: 'nowrap'
  }}>
                    {platform} ✅
                  </span>)}
              </div>
            </td>
          </tr>
        </tbody>
      </table>
    </div>;
};

<RunnerMetadata runnerType={`${maia} Hybrid`} platforms={["AWS", "Azure", "Snowflake"]} />

This document contains additional information for configuring connectivity to a [Hybrid SaaS](/docs/guides/runner-overview#hybrid-saas) {m_runner}. It covers configuration considerations for common use cases, such as using the {m_runner} with a proxy server.

{m_runner}s don't interact with proxy servers by default, but can be configured to do so if required. This is true of both AWS and Azure hosted {m_runner}s.

There is no support for using proxy servers with Matillion-hosted {m_runner}s in a Full SaaS solution.

<Note>
  This article is not intended as a guide for how to set up a proxy server; we assume you are already using a proxy in your infrastructure, and need to know how to use your {m_runner} with it.
</Note>

***

## IP allow list

If your account uses IP restrictions, you must also add your {m_runner}'s outbound IP address or range to the {maia} IP allow list. For more information, read [IP allow list](/docs/administration/ip-allow-list).

***

## Environment variables for outbound connections

There are a number of optional environment variables that must be set to configure outbound connections for the {m_runner}. These are:

| Variable               | Description                                                                                                                      |                |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| PROXY\_HTTP            | Holds your HTTP proxy server name and port used. For example: `myproxy.com:3000`.                                                |                |
| PROXY\_HTTPS           | Holds your HTTPS proxy server name and port used. For example: `myproxy.com:3000`.                                               |                |
| PROXY\_EXCLUDES        | Lists addresses for the proxy to ignore. Separate multiple addresses using a pipe character. For example: \`example.com          | example.net\`. |
| CUSTOM\_CERT\_LOCATION | Points to the storage location for custom certificates that you want the {m_runner} to trust. For example, `my_storage/my_certs` |                |

For more information on setting these, read [Optional {m_runner} parameters](/docs/guides/optional-runner-parameters).
