OpenSearch

A distributed search and analytics engine, an open-source fork of Elasticsearch. Ideal for full-text search, log analysis, observability, and dashboards with OpenSearch Dashboards.

Version:

3.0.0

back to Marketplace

VM Requisites

Resource Minimun
CPU 4 vCPU
RAM 8 GB
Disk 50 GB
Operating System Ubuntu 22.04 / 24.04

Access Port

Port Protocol Usage
30920 HTTPS OpenSearch REST API

How To Access

Verify that OpenSearch is responding

curl -k -u admin:<PASSWORD> https://<IP_DE_LA_VM>:30920/

Expected output

{
  "name": "opensearch-node",
  "cluster_name": "...",
  "version": { "number": "2.x.x" }
}

Cluster status

curl -k -u admin:<PASSWORD> https://<IP_DE_LA_VM>:30920/_cluster/health?pretty

ℹ️ OpenSearch uses HTTPS with self-signed certificates. Use `-k` in curl or configure your client to accept self-signed certificates. If you didn't set a password during deployment, look for it in the deployment outputs in the Cuemby portal.

Verify that OpenSearch is active

# View the OpenSearch pod
`kubectl get pods -A | grep opensearch`

# View the installation log
`tail -f /var/log/cuemby/bootstrap.log`

Expected output

NAME                           READY   STATUS    RESTARTS
opensearch-xxxxxxxxx-xxxxx     1/1     Running   0        ← Running ✓

⚠️ OpenSearch may take 5–8 minutes to become available. It is a large application that initializes system indexes on first boot.

Configuration Parameters

Parameter Default Description
OPENSEARCH_PASSWORD ⚠️ auto-generated Admin user password.
OPENSEARCH_CLUSTER_NAME opensearch-cluster Logical name of the cluster.
OPENSEARCH_DATA_SIZE 30Gi Persistent volume size for indexes and data.
OPENSEARCH_JAVA_OPTS -Xmx2g -Xms2g JVM heap options. Recommended: 50% of total RAM maximum.
OPENSEARCH_SSL_ENABLED true Enable HTTPS in the API with automatic certificate via sslip.io.
OPENSEARCH_HOSTNAME auto (sslip.io) Custom hostname. If left blank, the URL generated by Cuemby will be used.

First Steps (quick start)

Create an index

curl -k -u admin:<PASSWORD> -X PUT https://<IP_DE_LA_VM>:30920/mi-indice \
  -H "Content-Type: application/json" \
  -d '{"settings": {"number_of_shards": 1, "number_of_replicas": 0}}'

Index a document

curl -k -u admin:<PASSWORD> -X POST https://<VM_IP>:30920/my-index/_doc

-H "Content-Type: application/json"

-d '{"title": "OpenSearch on Cuemby", "content": "Distributed Search Engine"}'

Search for documents

curl -k -u admin:<PASSWORD> -X GET https://<VM_IP>:30920/my-indice/_search?pretty \ 
-H "Content-Type: application/json" \ 
-d '{"query": {"match": {"content": "search"}}}'

List indexes

curl -k -u admin:<PASSWORD> https://<IP_DE_LA_VM>:30920/_cat/indices?v

💡 Tip: OpenSearch is compatible with the Elasticsearch API. Clients like opensearch-py (Python), @opensearch-project/opensearch (Node.js), and the official Java SDK work directly. You can also use Elasticsearch clients by pointing to your instance's URL.

Quick Troubleshooting

Problem Probable cause Solution
Connection refused OpenSearch still initializing Wait 5–8 min and check tail -f /var/log/cuemby/bootstrap.log.
401 Unauthorized Incorrect credentials Review the deployment outputs in the Cuemby portal.
Cluster in network Indexes with unassigned shards On a single node, create indexes with "number_of_replicas": 0.
OutOfMemoryError Insufficient Heap JVM Increase OPENSEARCH JAVA_OPTS to -Xmx4g -Xms4g and restart the pod.
Pod in CrashLoopBackOff Insufficient RAM or disk space Verify that the VM has at least 8 GB of RAM and 50 GB of disk space.

Cuemby Cloud

IaaS

About Cuemby Cloud

Cuemby Cloud is enterprise-grade cloud infrastructure managed from a single console, built for stronger security, predictable operations, and easy scaling across regions.

Datacenters regions available in Colombia, Ecuador, and Chile

Backed by Tier III / Tier IV data center locations

Zero Network Ingress and Egress Fees

24/7 local expert support

Ready to Modernize Your Enterprise?

Future challenges demand future-ready solutions.
Let’s get started!

© Copyright | Cuemby® 2025