Skip to main content

object-storage

object-storage — ɳSelf documentation.

Object Storage Plugin

Multi-provider S3-compatible object storage API with presigned URL generation, multipart uploads, and access logging. Pro plugin.

Requires: A paid bundle license or ɳSelf+. nself license set nself_pro_...

Install

nself license set nself_pro_xxxxx...
nself plugin install object-storage

What It Does

Provides a unified S3-compatible object storage API across multiple providers including MinIO, AWS S3, Cloudflare R2, Backblaze B2, Google Cloud Storage, and Azure Blob Storage. Supports presigned URL generation for client-side uploads and downloads, multipart upload orchestration for large files, and full access logging to Postgres. Switch providers by changing a single env var with no application code changes.

Configuration

Env Var Default Description
OBJECT_STORAGE_PORT 3301 Port the Object Storage plugin service listens on
OBJECT_STORAGE_PROVIDER none Storage provider: minio, s3, r2, b2, gcs, azure
OBJECT_STORAGE_BUCKET none Default bucket name
OBJECT_STORAGE_REGION none Storage region (provider-dependent)

Ports

Port Purpose
3301 Object Storage plugin HTTP service

Database Tables

5 tables added to your Postgres database.

  • np_object_storage_buckets: Bucket metadata and configuration
  • np_object_storage_objects: Object index and metadata
  • np_object_storage_presigned: Presigned URL issuance log
  • np_object_storage_multipart: In-progress and completed multipart uploads
  • np_object_storage_access_log: Object access and operation audit log

Nginx Routes

Route Description
/storage/ Proxied to Object Storage plugin service on port 3301