Send feedback
  
   
 
  
    
      Part 2: Runtime quickstart 
  
      
     
  
  
  
   
  
    
  
  
    
    
    
    
    
    
  
  
  
  
  
    
    
    
  You are currently viewing version 1.2 of the
  Apigee hybrid documentation.  This version is end of life.  You should upgrade to a
  newer version. For more information, see
  Supported versions . 
  
  
  
  
  
  
  
  
  
  
  
  
  
    
    
    
    
    
    
    
    
 
 
 
  
    
    
  Version 1.2 (unsupported)keyboard_arrow_down  
  
 
   
UPGRADING:  If you are upgrading from v1.1.x to
v1.2.0, see Upgrading Apigee hybrid  for instructions. If you are performing
a new installation, continue with the configurations described below. 
  You can install hybrid runtime on the following platforms:
Prerequisites 
This section describes tasks you must accomplish before you begin the runtime plane quickstart
install.
  
    
      
        
          To ensure that you can successfully begin the runtime installation (as described in
          this section): 
         
       
      
        
          
         
       
      
        
          
         
       
     
  
  Note about clusters:  You can create a new separate cluster for
    Apigee hybrid or you can install it  in a cluster that is running other workloads. 
    
      Shared cluster:  If you install Apigee hybrid in a cluster running other
        workloads, you need to Upgrade and maintain your GKE/AKS cluster at the versions and features
        required in common for Apigee hybrid and for your other workloads. You may want to develop
        a plan to migrate one or more workloads in case conflicts arise between supported versions and
        requirements. 
      Separate cluster:  Creating a dedicated cluster Apigee hybrid adds
        isolation. It also adds the operational effort of maintaining the new cluster. 
     
    Both options are valid.
   
After you have satisfied the above prerequisites, you can continue with the steps in
the next section .
Process overview 
  The general process for performing the runtime quickstart is as follows:
  Create a cluster and set up your shell environment. 
  Install apigeectl, plus set up your hybrid project directories, create service accounts, and create TLS certs. 
  Configure the cluster by creating and then applying the settings in an overrides file. 
  Install hybrid runtime, enable Synchronizer access, and expose the MART endpoint to your hybrid organization. 
 
To get started, go to the quickstart for your platform:
  
  
  
     
  
  
 
  
    
    
      
       
         
  
  
    
    Send feedback
  
   
 
       
    
    
  
  
 
  Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
  Last updated 2025-10-29 UTC.
 
 
  
  
    
    
    
      
  
  
    Need to tell us more?
  
   
 
     
  
  
    
      [[["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-10-29 UTC."],[],[]]