NATS

Object Store Commands

Store and retrieve large objects (files, blobs) in NATS JetStream. Object Store handles chunking, checksums, and metadata for files that exceed message size limits.

5 commands

Pro Tips

Create a bucket: 'nats object add FILES --max-bucket-size 1GB' with size limits.

Upload a file: 'nats object put FILES ./report.pdf' — automatically chunks and checksums.

List objects: 'nats object ls FILES' shows all stored objects with sizes and timestamps.

Common Mistakes

Object Store is built on JetStream. It's not a replacement for S3 — use it for smaller, application-level storage.

Large objects are chunked into multiple messages. Ensure your stream has enough storage capacity.

Commands

Create object store

$ nats obj add files --description 'File storage'

Create object store bucket.

Upload file

$ nats obj put files ./myfile.pdf

Upload file to object store.

Download file

$ nats obj get files myfile.pdf

Download file from object store.

List objects

$ nats obj ls files

List objects in bucket.

Delete object

$ nats obj rm files myfile.pdf --force

Delete file from bucket.