Associating Controller with CoPilot
By default, CoPilot is already associated with your Controller after CoPilot deployment. If you want to reset this association, such as to point Controller to a different CoPilot instance or to recover from a lost association, use the following steps.- In Aviatrix Controller, go to the Environment tab. This is the default landing page after you log in.
- If a CoPilot instance is already associated, click Reset Association to clear the existing association before associating a different instance.
- Click Deploy CoPilot, then select Associate CoPilot from the dropdown.
- Enter the Public IP/FQDN and IP Address of your running CoPilot instance, then click Save.
The Environment tab does not support entering a separate CoPilot FQDN for
browser-based redirects (such as the redirect Controller performs after a SAML
login) apart from the address used for gateway log delivery. To configure that
field, use Legacy Controller UI, as described in the next section.
Setting a Separate CoPilot FQDN for Browser Redirects
This field is only available from Legacy Controller UI. Click Legacy
Controller UI in the Controller header to access it.
- From Legacy Controller UI, go to Settings > CoPilot > CoPilot Association and check whether your Controller is associated with CoPilot.
- For CoPilot FQDN (Optional), enter a hostname if your browser needs to reach CoPilot at a different address than the one gateways use to send logs. Use this field when “Public IP” points to an endpoint that is not suitable for browser access, such as a load balancer configured for the mTLS connection that gateways use to deliver logs. When “CoPilot FQDN” is set, Controller and CoPilot use it for browser-based redirects, including the redirect Controller performs after a SAML login. If this field is blank, “Public IP” continues to be used for these redirects, matching the previous behavior. The value must be a valid IP address or DNS hostname. Leave this field blank if a single address already works for both browser access and log delivery. No action is required for an existing CoPilot Association.
- Click Save.