Introduction to Novisurf

What is Novisurf?

Novisurf provides multi-node object storage with built-in security and observability so you can store, serve, and monitor files for your applications from a single platform.

Use Novisurf Storage to manage buckets, upload and serve files, control public access, and track usage and firewall activity through an integrated dashboard.

Core storage model

Novisurf Storage organizes all file data into buckets and backs those buckets with different storage backends.

• Multi-node backends — Buckets can run on on-prem infrastructure (ONPREM) or network file storage (NF), giving you flexibility in how and where data is stored.
• Buckets as the unit of organization — Group files by application, environment, tenant, or feature. Apply access controls, quotas, and monitoring policies at the bucket level.
• Public file serving — When you mark a bucket as public, files are served directly from the Novisurf Storage domain at https://storage.novisurf.top/{bucket}/{filename}.

This model lets you treat storage as a single logical layer while Novisurf handles details like which nodes store your data and how files are routed.

Key capabilities

Novisurf focuses on storage, access control, and visibility so you can integrate files into your product without building your own storage layer.

Multi-node object storage

Multi-node storage lets Novisurf place your data across different backends while exposing a single, consistent storage interface.

• ONPREM storage — Use ONPREM when you need buckets backed by on-premises infrastructure, such as data centers you manage or dedicated appliances.
• NF storage — Use NF for buckets that live on network file storage, ideal for cloud-native deployments and elastic capacity.
• Unified access — Regardless of backend type, interact with buckets and objects in the same way, while Novisurf handles replication, routing, and node-level details.

This approach helps you mix and match storage strategies without changing how your application works with files.

Firewall analytics and security

Firewall analytics show how requests interact with your storage layer so you can tune security and understand threat patterns.

• Visibility into blocked traffic — Track denied and challenged requests to understand which buckets see the most suspicious activity.
• Per-bucket insights — Review analytics bucket by bucket to see how rules affect specific apps, tenants, or environments.
• Security posture monitoring — Use these insights to adjust firewall rules, rate limits, and access controls to balance security and usability.

With firewall analytics in place, you avoid treating storage as a blind spot in your security stack.

Quota tracking and monitoring

Quota tracking and monitoring help you keep storage usage within your plan and predict when to scale.

• Storage capacity — Monitor how much space each project consumes and how close you are to storage limits, including free tier allowances.
• Operation counts — Track read and write operations per project so you can detect spikes and optimize hot paths.
• Planning and governance — Use quota data to forecast growth, set internal policies, and prevent unexpected throttling or overages.

By combining capacity and operations data, Novisurf gives you a complete view of how your storage is being used.

Public and private buckets

Bucket-level access controls determine how files are exposed to your users and services.

• Private buckets — Keep buckets private when you want all file access to flow through your own backend, where you can enforce authentication, authorization, and business logic.
• Public buckets — Mark buckets as public when you want to serve assets such as profile images, marketing graphics, or downloadable content directly from Novisurf.
• Public file URLs — Public files use the Novisurf Storage domain, following the pattern https://storage.novisurf.top/{bucket}/{filename}, which you can embed directly in your applications.

Choosing between public and private buckets lets you tailor access patterns to the type of content you store.

Dashboard experience

The Novisurf dashboard centralizes control and observability for your storage projects.

• Project overview — See a high-level summary of quotas, storage usage, and recent activity across your project.
• Storage browser — Browse buckets and objects, inspect file metadata, and verify that uploads and access controls behave as expected.
• Firewall analytics — Explore firewall decisions and traffic patterns visually, drilling into specific buckets and time ranges.
• Project settings — Configure project-level settings, including API keys, access control defaults, and other storage-related options.

The dashboard gives you a visual counterpart to your programmatic workflows, making it easier to debug and operate your storage setup.

Developer tooling

Developers integrate with Novisurf Storage through APIs and an official JavaScript and TypeScript SDK.

The SDK wraps common operations like bucket management, uploads, downloads, analytics, and quota inspection in typed APIs so you can work with Novisurf directly from modern JS and TS projects.

Next steps

Explore these guides to move from overview to implementation.