1ctl nats

1ctl nats manages private NATS deployments in the active organization namespace. Choose the lightweight single-replica Core profile or a three-replica JetStream profile with persistent storage.

Usage

1ctl nats

Flags

Flag	Type	Required	Default	Description
--help, -h	boolean	No	—	Show help

Subcommands

Command	Description
create	Create core NATS or a three-node JetStream HA deployment
list	List NATS deployments
get	Show NATS deployment details
status	Show live NATS deployment status
credentials	Download NATS client credentials
delete	Delete a NATS deployment

Profiles

Create a single-replica Core deployment:

1ctl nats create events

Create a three-replica JetStream deployment with a persistent volume for each replica:

1ctl nats create events-ha \
  --jetstream \
  --storage-size 20Gi

CPU and memory flags apply per replica. --storage-size and --storage-class are valid only with --jetstream.

Placement

NATS uses automatic platform placement in the active organization namespace. The CLI does not currently expose a machine-pinning flag for NATS. For JetStream, select a storage class only when the cluster requires one:

1ctl nats create events-ha \
  --jetstream \
  --storage-size 20Gi \
  --storage-class ceph-block

The chosen storage class must be available wherever the workload is scheduled.

See Managed NATS for Core and JetStream workflows, credential handling, placement, and safe deletion.