What is Hypernode Object Storage?

Hypernode Object Storage provides an option to store media files, assets, backups, documents, etc in a persistent, remote storage container.

Object storage eliminates redundancy and provides a centralized, scalable solution for storing application assets, session data, and backups.

By default, media files are stored in the same filesystem that contains the application. This is inefficient for complex, multi-server configurations, and can result in degraded performance when sharing resources.

With Object Storage you get:

Effortless Data Sharing – Seamless access across all Hypernodes
Full Access Control & Security – Secure and manage your data with ease
Safe Backup & Monitoring – Ensure reliability with built-in insights

Getting started with Object Storage

CLI option

hypernode-object-storage --help

Creating a Hypernode Object Storage Workspace

SSH into your server.
Run hypernode-object-storage create
Fill in the prompts with a name and desired storage.
Confirm your order and give it a few minutes before your storage is ready.

Note: You can use one object storage across multiple Hypernodes. But you can only use one object storage space per Hypernode.

If you receive this error, please make sure to enable “Allow billing through CLI in the relevant Hypernode settings page”

You do not have permission to order object storage for this Hypernode. Please ask the Hypernode owner to enable 'Allow billing through the CLI' in the Control Panel settings or via the API

Retrieve object storage

Run hypernode-object-storage info
If you want to retrieve your credentials for the workspace pass in the flag --with-credentials.

The output should look like this

app@testhypernode ~ # hypernode-object-storage info

+--------------------------------------+--------------+--------+------------+----------------+---------------+---------------+
|                 UUID                 |     Name     |  Plan  | Hypernodes | Management URL |   Access Key  |   Secret Key  |
+--------------------------------------+--------------+--------+------------+----------------+---------------+---------------+
| d8770125-6c90-4770-b00f-1716f699990a | test-storage | OS50GB | testnode12 | **sensitive**  | **sensitive** | **sensitive** |
+--------------------------------------+--------------+--------+------------+----------------+---------------+---------------+

You can use the credentials and the URL now to configure remote storage for your application with the help of this document.

UI option - Control Panel

Coming soon