NATS JetStream

High-performance, low-latency messaging system with message persistence, streams, and consumers via JetStream. Ideal for microservices, event-driven architectures, and work queues.

Version:

2.12.4

back to Marketplace

VM Requisites

Resource Minimum
CPU 2 vCPU
RAM 4 GB
Disk 40 GB
Operating System Ubuntu 22.04 / 24.04

Access Port

Port Protocol Usage
30422 TCP NATS client (publish/subscribe, JetStream)
30822 HTTP Monitoring UI and Metrics API

How To Access

Connection URL

nats://<IP_DE_LA_VM>:30422

With token authentication

nats://<AUTH_TOKEN>@<IP_DE_LA_VM>:30422

ℹ️ If you did not configure the token during deployment, look for it in the deployment outputs in the Cuemby portal.

Verify connectivity with NATs CLI

# Install nats CLI
`curl -sf https://binaries.nats.dev/nats-io/natscli/nats@latest | sh`

# Verify connection
`nats server info` --server nats://<AUTH_TOKEN>@<VM_IP>:30422`

# Publish a test message
`nats pub my.subject "hello world"` --server nats://<AUTH_TOKEN>@<VM_IP>:30422`

# Subscribe to a subject
`nats sub my.subject` --server nats://<AUTH_TOKEN>@<VM_IP>:30422`

Connection strings by language

// Go (nats.go)
nc, _ := nats.Connect("nats://<IP_DE_LA_VM>:30422",
    nats.Token("<AUTH_TOKEN>"))
# Python (nats-py)
nc = await nats.connect("nats://<IP_DE_LA_VM>:30422",
    token="<AUTH_TOKEN>")
// Node.js (nats.ws / nats.js)
const nc = await connect({
    servers: "<IP_DE_LA_VM>:30422",
    token: "<AUTH_TOKEN>"
});

Monitoring UI

NATS exposes a real-time metrics dashboard on port 30822:

http://<IP_DE_LA_VM>:30822/

Useful endpoints:

# General server info
curl http://<VM_IP>:30822/varz

# JetStream status
curl http://<VM_IP>:30822/jsz

# Active connections
curl http://<VM_IP>:30822/connz

Verify that NATS is active

# View the NATS pod
`kubectl get pods -A | grep nats`

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

# Verify that the ports are listening
`ss -tlnp | grep -E '30422|30822'`

Expected output:

NAME                          READY   STATUS    RESTARTS
nats-jetstream-xxxxxxxxx      1/1     Running   0        ← Running ✓

Configuration Parameters

Parameter Default Description
NATS_AUTH_TOKEN ⚠️ auto-generated Authentication token for clients. If left blank, Cuemby generates one randomly.
NATS_DATA_SIZE 10Gi Persistent volume size for JetStream streams.

First Steps (quick start)

# Create a stream
nats stream add MY_STREAM
--subjects "events.>"
--storage file
--server nats://<AUTH_TOKEN>@<VM_IP>:30422

# View existing streams
nats stream ls
--server nats://<AUTH_TOKEN>@<VM_IP>:30422

# Publish a persisted message
nats pub events.new "{'id': 1, 'type': 'log'}"
--server nats://<AUTH_TOKEN>@<VM_IP>:30422

# Create a consumer and read messages
nats consumer add MY_STREAM MY_CONSUMER
--server nats://<AUTH_TOKEN>@<VM_IP>:30422

💡 Tip: JetStream uses `--storage file` for disk persistence and `--storage memory` for maximum speed without persistence. For production, always use `file`.

Quick Troubleshooting

Problem Probable cause Solution
Authorization Violation Incorrect or missing token Verify the token in the deployment outputs and include it in the connection URL.
Connection refused on 30422 NATS still in its initial stages Wait ~2–3 min and check tail -f /var/log/cuemby/bootstrap.log.
Messages do not persist Stream not created Create the stream with nats stream add before publishing with JetStream.
Monitoring is not responding in 30822 Pod not ready Verify that the pod is in Running with kubectl get pods -A | grep nats.
Pod in CrashLoopBackOff insufficient disk Check with kubectl describe pod -n .

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