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 Cloud Shell Config Builder

ComputeOCI

Build Cloud Shell configurations with private networking, persistent storage, and environment settings.

Last verified: May 2026

OCI Cloud Shell Configuration

Build Cloud Shell configurations with private networking, persistent storage, and custom environment settings.

Required Fields

compartmentIddisplayNameshellEnvironment.region

{
  "compartmentId": "ocid1.compartment.oc1..aaaaaaaexample",
  "displayName": "dev-cloud-shell-config",
  "description": "Cloud Shell configuration for development team",
  "networkingConfig": {
    "networkType": "PRIVATE",
    "vcnId": "ocid1.vcn.oc1.iad.aaaaaaaexample",
    "subnetId": "ocid1.subnet.oc1.iad.aaaaaaaexample",
    "nsgIds": ["ocid1.networksecuritygroup.oc1.iad.aaaaaaaexample"],
    "usePrivateDns": true
  },
  "persistentStorage": {
    "storageGb": 5,
    "homeDirectoryPersistence": true,
    "autoBackup": true,
    "retentionDays": 180
  },
  "shellEnvironment": {
    "shellType": "BASH",
    "region": "us-ashburn-1",
    "preInstalledTools": [
      "oci-cli",
      "terraform",
      "kubectl",
      "helm",
      "python3",
      "node",
      "docker"
    ],
    "customInitScript": "#!/bin/bash\nexport OCI_CLI_PROFILE=dev\nalias k=kubectl\nalias tf=terraform",
    "environmentVariables": {
      "OCI_CLI_PROFILE": "dev",
      "TF_VAR_compartment_id": "ocid1.compartment.oc1..aaaaaaaexample",
      "KUBECONFIG": "$HOME/.kube/config"
    }
  },
  "sessionConfig": {
    "idleTimeoutMinutes": 60,
    "maxSessionDurationMinutes": 1440,
    "webPreviewPort": 8080
  },
  "freeformTags": {
    "environment": "development",
    "team": "platform"
  }
}

Generated Output

Output will appear here...

See It in Action

Your team's developers each spend ~2 hours setting up local OCI CLI environments (downloading credentials, configuring OCI config files, installing tools). The builder helps standardize: every developer uses Cloud Shell with private networking enabled to reach the dev VCN. New developer onboarding for OCI tooling drops from 2 hours to 5 minutes. The persistent home directory means custom scripts and configs persist across sessions.

What This Tool Does

Build Cloud Shell configurations with private networking, persistent storage, and environment settings. 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.

Technical Details

The builder constructs Cloud Shell configurations: persistent storage size selection, optional private networking config (VCN + subnet binding for accessing private resources), pre-installed tooling list documentation, and shell environment setup (custom .bashrc / .profile snippets for OCI CLI defaults, kubectl contexts, terraform backend config). Output documentation guides users through enabling these settings via the OCI console (Cloud Shell config is mostly UI-driven, not API-managed).

Common Use Cases

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

Common 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.

Expert Tips

TIP

OCI Cloud Shell is FREE and includes pre-installed CLI tools, kubectl, oci CLI, ansible, terraform, and others. For most ad-hoc OCI operations, this is dramatically simpler than maintaining a local CLI environment with credentials. Persistent storage (5 GB) survives across sessions.

TIP

Cloud Shell has direct access to your tenancy with your user's IAM permissions — no extra auth needed. This is great for quick tasks but be careful about what you run there. For automation and CI/CD, use service accounts with explicit credentials, not Cloud Shell.

TIP

Private network mode lets Cloud Shell reach private VCN resources (private DBs, internal APIs) without bastion setup. Configure a network security group + private endpoint binding to enable this. Game-changer for debugging private-network workloads.

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.