You must add the IP address of theMARTendpoint
to your Apigee organization. You set this value previously when set
the value of themart.hostAliasproperty in your overrides
file.
The management plane needs this address so that it can communicate with the runtime
plane over MART.
Follow these steps to add the MART IP to your organization:
Get the value you set previously in your overrides file for themart.hostAliasproperty. For MART to function, the host alias must
be a fully qualified domain name.
Locate the service account key with theApigee Organization Adminrole
that you downloaded previously, as explained inAdd service accounts.
You need the path
to this JSON key file to complete the following steps.
Set theGOOGLE_APPLICATION_CREDENTIALSenvironment variable to the path where the
service account key is located:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThis documentation version (1.4) is end of life and users should upgrade to a newer version for continued support and updates.\u003c/p\u003e\n"],["\u003cp\u003eThe IP address of the MART endpoint, set previously as \u003ccode\u003emart.hostAlias\u003c/code\u003e, must be added to your Apigee organization.\u003c/p\u003e\n"],["\u003cp\u003eThe management plane requires the MART IP address to communicate with the runtime plane.\u003c/p\u003e\n"],["\u003cp\u003eUpdate the \u003ccode\u003eGOOGLE_APPLICATION_CREDENTIALS\u003c/code\u003e environment variable with the path to the Apigee Organization Admin service account key file.\u003c/p\u003e\n"],["\u003cp\u003eUse the provided Apigee API \u003ccode\u003ecurl\u003c/code\u003e command to update your organization with the MART endpoint, including the \u003ccode\u003ehttps://\u003c/code\u003e prefix.\u003c/p\u003e\n"]]],[],null,["# Add the MART IP to your org\n\n| You are currently viewing version 1.4 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\n\nYou must add the IP address of the [MART](/apigee/docs/hybrid/v1.4/what-is-hybrid#mart) endpoint\nto your Apigee organization. You set this value previously when set\nthe value of the `mart.hostAlias` property in your overrides\nfile.\nThe management plane needs this address so that it can communicate with the runtime\nplane over MART.\n\n\nFollow these steps to add the MART IP to your organization:\n| **NOTE:** Perform this step only after have successfully deployed hybrid into your cluster, as explained in [Deploy hybrid to your cluster](/apigee/docs/hybrid/v1.4/install-hybrid).\n\n1. Get the value you set previously in your overrides file for the `mart.hostAlias` property. For MART to function, the host alias must be a fully qualified domain name.\n2. Locate the service account key with the **Apigee Organization Admin** role that you downloaded previously, as explained in [Add service accounts](/apigee/docs/hybrid/v1.4/precog-serviceaccounts). You need the path to this JSON key file to complete the following steps.\n3. Set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable to the path where the\n service account key is located:\n\n export GOOGLE_APPLICATION_CREDENTIALS=\u003cvar translate=\"no\"\u003eyour_sa_credentials_file\u003c/var\u003e.json\n\n4. Call the following Apigee API to update your organization with the MART endpoint: \n\n ```\n curl -v -X PUT \\\n https://apigee.googleapis.com/v1/organizations/your_org_name \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer $(gcloud auth application-default print-access-token)\" \\\n -d '{\n \"name\" : \"your_org_name\",\n \"properties\" : {\n \"property\" : [ {\n \"name\" : \"features.hybrid.enabled\",\n \"value\" : \"true\"\n }, {\n \"name\" : \"features.mart.server.endpoint\",\n \"value\" : \"https://HOST_ALIAS_DNS\"\n } ]\n }\n }'\n ```\n\n Here is an example. Be sure to add the prefix \"https://\" to the domain name. \n\n ```\n curl -v -X PUT \\\n https://apigee.googleapis.com/v1/organizations/my_organization \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer $(gcloud auth application-default print-access-token)\" \\\n -d '{\n \"name\" : \"my_organization\",\n \"properties\" : {\n \"property\" : [ {\n \"name\" : \"features.hybrid.enabled\",\n \"value\" : \"true\"\n }, {\n \"name\" : \"features.mart.server.endpoint\",\n \"value\" : \"https://foo-mart.example.com\"\n } ]\n }\n }'\n ```"]]