Start with Storage
Get started quickly with Nuvix Storage. Follow step-by-step instructions to set up storage, upload files, and integrate cloud storage into your projects
You can create your first bucket, upload, and download your first file in minutes.
Create bucket
You can create a bucket in the Nuvix Console by navigating to Storage > Create bucket.
In your bucket, navigate to Settings > Permissions, then add a new Any role with CREATE and READ permissions. This allows anyone to create and read files in this bucket.
Create file
To upload a file, add this to your app. For web apps, you can use the File object directly. For Node.js apps, use the InputFile class.
import { Client, ID } from "@nuvix/client";
const nx = new Client()
.setEndpoint('https://api.nuvix.in/v1')
.setProject('<PROJECT_ID>');
// Upload file from file input
const file = document.getElementById('uploader').files[0];
const response = await nx.storage.createFile({
bucketId: '<BUCKET_ID>',
fileId: ID.unique(),
file: file
});
console.log(response); // Successimport { Client, ID, InputFile } from "@nuvix/client";
const nx = new Client()
.setEndpoint('https://api.nuvix.in/v1')
.setProject('<PROJECT_ID>');
// Upload from file path
const file = InputFile.fromPath('/path/to/file.jpg', 'file.jpg');
const response = await nx.storage.createFile({
bucketId: '<BUCKET_ID>',
fileId: ID.unique(),
file: file
});
console.log(response); // SuccessDownload file
To download a file, use the getFileDownload method.
import { Client } from "@nuvix/client";
const nx = new Client()
.setEndpoint('https://api.nuvix.in/v1')
.setProject('<PROJECT_ID>');
// Download file
const result = await nx.storage.getFileDownload({
bucketId: '<BUCKET_ID>',
fileId: '<FILE_ID>'
});
console.log(result); // File data or URLimport { useState, useEffect } from 'react';
import { Client } from "@nuvix/client";
function FileViewer({ bucketId, fileId }) {
const [fileUrl, setFileUrl] = useState(null);
const [loading, setLoading] = useState(true);
useEffect(() => {
const nx = new Client()
.setEndpoint('https://api.nuvix.in/v1')
.setProject('<PROJECT_ID>');
nx.storage.getFileDownload({
bucketId: bucketId,
fileId: fileId
}).then((url) => {
setFileUrl(url);
setLoading(false);
}).catch((error) => {
console.error('Error downloading file:', error);
setLoading(false);
});
}, [bucketId, fileId]);
if (loading) return <div>Loading...</div>;
if (!fileUrl) return <div>File not found</div>;
return <img src={fileUrl} alt="Downloaded file" />;
}That's it! You now have working file nx.storage. Check out our storage security guide to learn about permissions and access control.
How is this guide?
Last updated on
Storage permissions
Enhance data security and control with Nuvix Storage Permissions. Learn how to set access rules, permissions, and restrictions for your stored files.
Upload and download
Effortlessly upload and download files with Nuvix Storage. Learn how to handle file uploads, manage file versions, and ensure secure downloads in your applications.