Does this tool connect to my OCI account?

No. This tool runs entirely in your browser and generates configuration JSON that you can copy and paste into your infrastructure-as-code templates, CLI commands, or cloud console. It never connects to any cloud account or sends data externally.

Are the generated configurations production-ready?

The tool produces syntactically valid configurations based on current OCI service specifications. Always review generated configs against your organization security policies and test in a non-production environment before deploying.

OCI Instance Configuration Builder

ComputeOCI

Build instance configuration templates for instance pools with shape, image, and block volumes.

Last verified: May 2026

OCI Instance Configuration Configuration

Build instance configuration templates for instance pools with shape, image, networking, and block volumes.

Required Fields

compartmentIddisplayNameinstanceDetails.launchDetails.shapeinstanceDetails.launchDetails.sourceDetails

{
  "compartmentId": "ocid1.compartment.oc1..aaaaaaaexample",
  "displayName": "prod-web-instance-config",
  "description": "Instance configuration template for production web server pool",
  "instanceDetails": {
    "instanceType": "compute",
    "launchDetails": {
      "compartmentId": "ocid1.compartment.oc1..aaaaaaaexample",
      "shape": "VM.Standard.E4.Flex",
      "shapeConfig": {
        "ocpus": 4,
        "memoryInGBs": 64,
        "baselineOcpuUtilization": "BASELINE_1_1"
      },
      "sourceDetails": {
        "sourceType": "image",
        "imageId": "ocid1.image.oc1.iad.aaaaaaaexample",
        "bootVolumeSizeInGBs": 100,
        "bootVolumeVpusPerGB": 20
      },
      "createVnicDetails": {
        "subnetId": "ocid1.subnet.oc1.iad.aaaaaaaexample",
        "nsgIds": ["ocid1.networksecuritygroup.oc1.iad.aaaaaaaexample"],
        "assignPublicIp": false,
        "assignPrivateDnsRecord": true
      },
      "availabilityConfig": {
        "recoveryAction": "RESTORE_INSTANCE",
        "isLiveMigrationPreferred": true
      },
      "metadata": {
        "ssh_authorized_keys": "ssh-rsa AAAA...example",
        "user_data": "IyEvYmluL2Jhc2gKZWNobyAnSGVsbG8gV29ybGQn"
      },
      "agentConfig": {
        "isMonitoringDisabled": false,
        "isManagementDisabled": false,
        "pluginsConfig": [
          { "name": "OS Management Service Agent", "desiredState": "ENABLED" },
          { "name": "Compute Instance Run Command", "desiredState": "ENABLED" },
          { "name": "Vulnerability Scanning", "desiredState": "ENABLED" }
        ]
      }
    },
    "blockVolumes": [
      {
        "createDetails": {
          "displayName": "data-volume",
          "sizeInGBs": 500,
          "vpusPerGB": 20
        },
        "attachDetails": {
          "type": "paravirtualized",
          "isPvEncryptionInTransitEnabled": true,
          "device": "/dev/oracleoci/oraclevdb"
        }
      }
    ]
  },
  "freeformTags": {
    "environment": "production",
    "team": "compute"
  }
}

Generated Output

Output will appear here...

About This Tool

Build instance configuration templates for instance pools with shape, image, and block volumes. This tool helps OCI engineers generate valid configurations quickly without consulting documentation, reducing errors and accelerating infrastructure deployment. All processing runs in your browser with no data sent to external servers.

Real-World Scenario

Your team has 4 instance pools (web, app, worker, batch) currently each defined with hand-crafted configurations. The builder generates: 4 instance configurations using a shared template structure, each with specific shape/image differences. After migration, updates flow consistently — change the AMI in one configuration, rolling-replace the pool to pick it up. Operational burden drops from 'maintain 4 separate config sets' to 'maintain 1 template + 4 small overrides'.

When to Use This Tool

•Generating oci instanceuration configurations for new infrastructure deployments.
•Validating existing configurations against best practices before applying changes.
•Learning OCI service configuration patterns through interactive examples.
•Accelerating infrastructure-as-code development by producing correct JSON/YAML starting points.

Pro Tips

TIP

Instance configurations are the TEMPLATE used by Instance Pools. Define once in the configuration, instantiate many times in the pool. Updates to the configuration apply to NEW instances launched from it, not existing instances — to update existing, recreate the pool or use rolling replacement.

TIP

Reuse instance configurations across multiple pools when shapes/images/networking are identical. A single 'standard-web-tier-config' can underpin dev, staging, and production pools. Updates flow through one configuration to all pools that reference it.

TIP

Always include cloud-init user data in the configuration. The user data script bootstraps each new instance: install dependencies, pull config, register with monitoring. Without user data, every new instance from the pool requires manual configuration — defeating the point of pools.

How It Works Under the Hood

The builder constructs OCI Instance Configuration definitions: instanceType=compute, instance details (compartment, shape, OCPU/memory for Flex, AD/FD placement, image OCID, boot volume size, additional block volumes), networking (subnet OCID, NSG list, primary VNIC details with assign-public-ip, hostname), metadata including ssh_authorized_keys and user_data (base64-encoded cloud-init script), and tags. Output is generated as oci compute-management instance-configuration commands and Terraform oci_core_instance_configuration resources.

Frequently Asked Questions

Does this tool connect to my OCI account?: No. This tool runs entirely in your browser and generates configuration JSON that you can copy and paste into your infrastructure-as-code templates, CLI commands, or cloud console. It never connects to any cloud account or sends data externally.
Are the generated configurations production-ready?: The tool produces syntactically valid configurations based on current OCI service specifications. Always review generated configs against your organization security policies and test in a non-production environment before deploying.

Related Learning Guides

OCI Compute Shapes & Instances18 min read
OKE: Kubernetes on Oracle Cloud22 min read

Was this tool helpful?

Disclaimer: This tool runs entirely in your browser. No data is sent to our servers. Always verify outputs before using them in production. AWS, Azure, and GCP are trademarks of their respective owners.