You can create an environment and add one or more service instances to it. For example, you can add an Oracle Visual Builder instance as well as an Oracle Cloud Applications instance to an environment.

1. In the left navigator, click Environments .
2. Click Create (or + Create Environment if the page is empty).
3. In Environment Name, enter a unique name and, in Description, enter a description.
4. Click Create.
5. In the Service Instances tab, click + Add Instance.
6. In the Add Service Instance dialog, select the type of service instance: Visual Builder and Oracle Integration, Oracle Cloud Applications, or Infrastructure Services. Depending on the selected instance type, you'll see a list of service instances available to add to the environment:
   • The Visual Builder and Oracle Integration instance list shows resources in a selected compartment that are connected to an OCI account and authorized for use by VB Studio. Additionally, these instances can be from the same identity domain as your VB Studio instance or a different one. If you don't see any instances even after selecting the correct region and compartment, make sure VB Studio has the authorization required to access these instances. See Authorize VB Studio to Access Visual Builder and Integration Instances.

     Note:

     If you have existing environments with IDCS resources, you can continue to use these environments, but if you're creating a new environment, only the Visual Builder instances that are linked to your OCI account will be available to add to the environment.
   • The Oracle Cloud Applications list only includes IDCS resources, labeled as such.
   • The Infrastructure Services list only includes legacy PaaS instances, or instances that are not Visual Builder, Integration, or Oracle Cloud Applications.

   Here's how you add a new instance to an environment:

   • To add a Visual Builder instance connected to an OCI account, select Visual Builder and Oracle Integration under Instance Type and Instance List under Add Instance Using, click next to OCI Details and choose the region and compartment where your Visual Builder is, then select an instance from the list. (If your environment already contains a Visual Builder instance, you'll need to remove it before adding a different one.)
     
     Description of the illustration env-addserviceinstances.png
     

     To add an instance that's doesn't show in the Instance list (because it's connected to a different OCI account), select Visual Builder and Oracle Integration under Instance Type and Visual Builder Credentials under Add Instance Using. You'll need the instance's base URL, instance name, and user credentials to add an instance this way. (Note though that using this approach won’t allow you to set up OAuth for this environment in the deployment build job, used by the Publish action in the Designer.)

     Typically, the Visual Builder instance added to your visual application's environment uses the same identity domain as your VB Studio instance. If you choose a Visual Builder instance from a different identity domain as your deployment environment, you may see a warning about setting up the Allowed Origins configuration. Talk to your administrator to make sure your instance's domain is added to its list of allowed origins, as described in Allow Other Domains Access to Services.

     When your Visual Builder instance uses a different identity domain than your VB Studio instance, OAuth tokens (via three-legged OAuth flows) are used to secure programmatic access to the target instance. Before any OAuth tokens can be created, you must provide authorization to acquire OAuth tokens. Click Authorize when prompted, then sign in with credentials to connect and deploy to the target instance.

     Note:

     If you plan to use VB Studio's Oracle Integration build steps (see Move Oracle Integration Projects, Artifacts, Packages, and Lookups Between Instances), you can add Oracle Integration instances to your Environment definition. Follow the instructions in Add an Oracle Integration Instance to an Environment for adding an Integration instance to an environment. You can add a Visual Builder as well as an Integration instance to an environment.

   • To add an Oracle Cloud Applications instance in the same identity domain to an environment, select Oracle Cloud Applications under Instance Type and Identity Domain under Add Instance Using, then select an instance. (You can't change the identity domain for Oracle Cloud Applications.)

     If you're viewing an environment that already contains services from another stripe, you'll see a message that the service instance is in a different identity domain and no details about it will be displayed. This is expected behavior. To add an Oracle Cloud Application from a different identity domain, select Oracle Cloud Applications under Instance Type and Application Credentials under Add Instance Using. You'll need the base Oracle Cloud Application's URL and the credentials of a user who can access the instance. See Add the Oracle Cloud Application's Production Instance to an Environment.

   • To add an Infrastructure Services instance—such as Java Cloud Service (JCS)—to an environment, you'll need the instance's region, identity domain ID, and the credentials of a user who can access the instance to display a list of the resources you can add to the environment:
     
     Description of the illustration add-infrastructure-services.png
     

     Note:

     With Oracle Java Cloud Service reaching End of Life (EOL) in May 2025, support for JCS deployments in VB Studio is now deprecated. See Deprecated Features in What's New in Visual Builder Studio?.
7. If necessary, repeat steps 5 and 6 to find and add additional service instances.