IBM Cloud Docs
Configuring a proxy for your Satellite Connector

Configuring a proxy for your Satellite Connector

You can use a proxy to establish tunnel connection for your Satellite Connector.

There are various ways to setup a proxy. These instructions assume that you have a properly configured proxy, which is accessible from the machine running the Connector agent. The following instructions have been tested with the Connector agent machine running Ubuntu 22.04 with an explicit Squid proxy running on a different machine from the Connector agent.

  1. Create a Connector.

  2. On the Connector agent, ensure that your Docker runtime is using the proxy so that you can log in and pull images from icr.io. For more information, see Configure the Docker daemon to use a proxy server.

  3. In your environment variable file for the Connector agent (~/agent/env-files/env.txt from the previous example), add the following environment variables with your proxy information.

    HTTP_PROXY=http://my.proxy.example.com:3128
    HTTPS_PROXY=https://my.proxy.example.com:3129
    

    For example, if you use an HTTP proxy, the env.txt file is similar to:

    SATELLITE_CONNECTOR_ID=U2.....wZyI
    SATELLITE_CONNECTOR_IAM_APIKEY=/agent-env-files/apikey
    SATELLITE_CONNECTOR_REGION=us-south
    SATELLITE_CONNECTOR_TAGS=my tag
    HTTP_PROXY=http://192.168.3.87:3128
    HTTPS_PROXY=http://192.168.3.87:3128