Deploy Oracle MicroTx Free on OCI with Oracle Cloud Marketplace
Provision a new Oracle Kubernetes Engine cluster and deploy MicroTx Free using the Oracle Cloud Marketplace Terraform stack.
Oracle Cloud Marketplace provides a guided route to deploy Oracle MicroTx Free in Oracle Cloud Infrastructure (OCI). The Marketplace stack uses Terraform to provision the required OCI resources, create a new Oracle Kubernetes Engine (OKE) cluster, and deploy MicroTx to that cluster. It does not deploy to an existing OKE cluster.
Before you begin
Prepare an OCI account with permissions to provision the required OCI resources, including a new OKE cluster and related networking. Complete the prerequisites and review the minimum resource requirements for the complete Terraform stack, including OKE worker nodes, the database, load balancer, file storage, and jump host.
Deploy from Marketplace
- Search Oracle Cloud Marketplace for Oracle MicroTx, then select Oracle MicroTx Free.
- Select Get App, then launch the supplied stack in OCI Resource Manager.
- Provide the stack inputs described below.
- Review the execution plan and apply the stack.
- Monitor the Apply Job. When it completes, use the stack outputs and deployment instructions to access MicroTx.
Stack inputs
The Marketplace form groups the main inputs into the following sections. For field-level guidance and the complete provisioning procedure, use the official Oracle deployment guide.
- MicroTx Configurations: Select the MicroTx version to install and enter a deployment name, which prefixes generated OCI resources. Enter a domain name for the MicroTx HTTPS hostname; the stack generates
<Deployment Name>.<Domain Name>, such asmicrotx-demo.example.com, and uses a self-signed certificate to secure TLS access to the endpoint. - Database Configuration: Connect MicroTx to your own Oracle Database, or have the stack provision an Oracle Autonomous AI Database in the FREE, DEVELOPER, or PAID edition.
- Workflow Server Secret: Upload the
encryption.keyfile used to encrypt and store sensitive Workflow Server data. Create the key by following the encryption-key prerequisites. - Kubernetes Cluster Configurations: Configure the worker node-pool name, autoscaling and its minimum and maximum worker-node counts, node instance shape, OCPUs, and memory.
Access MicroTx
After the Apply Job completes, open its output values and complete the following steps:
- Copy the
hosts_entryoutput, for example129.xx.xx.xx microtx-demo.example.com, to your local/etc/hostsfile. - Open the
launch_microtxoutput URL, for examplehttps://microtx-demo.example.com/consoleui/, to access the MicroTx Console UI. - The stack uses a self-signed TLS certificate, so your browser might display a security warning. Accept the warning to continue to the Console UI.
Next steps
Explore the MicroTx Workflow samples for workflow-based orchestration. For distributed transactions, use the XA, LRA, or TCC samples. Select the pattern that fits the consistency and compensation needs of your services. For the complete Marketplace procedure and every stack option, see the official Oracle deployment guide.
Also explore
The quick-start documentation covers deployment paths for a local Minikube environment and an OKE cluster.