Skip to main content

Storage

Manage file storage buckets and objects for your application.

Overview​

Storage provides a scalable file storage system for your applications. Create buckets to organize files, upload and download objects, and manage access permissions.

Concepts​

Bucket​

A container for storing files. Buckets organize objects and can have their own access policies and settings.

Object​

A file stored in a bucket. Objects can be any file type including images, documents, videos, and data files.

Storage Quota​

The total amount of storage space available based on your subscription plan.

View Buckets​

  1. Navigate to your App in the Dashboard.
  2. Click Storage in the sidebar.
  3. View all buckets with:
    • Bucket Name: Display name
    • Objects: Number of files
    • Size: Total storage used
    • Created: When the bucket was created

Create a Bucket​

  1. Navigate to Storage in your app.
  2. Click Create Bucket.
  3. Fill in the bucket details:
    • Name: Descriptive bucket name
    • Slug: URL identifier (auto-generated)
    • Description: Purpose of the bucket
    • Public: Whether files are publicly accessible
  4. Click Create.
tip

Use descriptive names that indicate what type of files the bucket contains, such as "user-uploads", "product-images", or "documents".

View Bucket Contents​

  1. Click on a bucket in the list.
  2. View all objects with:
    • File Name: Object name
    • Size: File size
    • Type: MIME type
    • Uploaded: Upload timestamp

Search Files​

  1. Use the search bar to filter by filename.
  2. Results update as you type.

Upload Files​

Single File Upload​

  1. Navigate to a bucket.
  2. Click Upload.
  3. Select a file from your device.
  4. Wait for upload to complete.

Drag and Drop​

  1. Navigate to a bucket.
  2. Drag files from your file manager.
  3. Drop onto the upload zone.
  4. Files upload automatically.

Multiple Files​

  1. Select multiple files when uploading.
  2. All files upload to the current bucket.

Download Files​

  1. Navigate to the bucket containing the file.
  2. Click on the file to view details.
  3. Click Download.
  4. Save the file to your device.

Delete Files​

  1. Navigate to the bucket.
  2. Find the file in the list.
  3. Click the Delete (trash) icon.
  4. Confirm deletion.

Bulk Delete​

  1. Select multiple files using checkboxes.
  2. Click Delete Selected.
  3. Confirm deletion.
warning

Deleted files cannot be recovered. Ensure you have backups of important files before deletion.

Edit Bucket Settings​

  1. Navigate to Storage in your app.
  2. Click the Edit icon on the bucket.
  3. Update settings:
    • Name: Change display name
    • Description: Update description
    • Public: Toggle public access
  4. Click Save.

Delete a Bucket​

  1. Navigate to Storage in your app.
  2. Click the Delete (trash) icon on the bucket.
  3. Confirm deletion.
warning

Deleting a bucket removes all files inside it. This action cannot be undone.

Storage Usage​

Monitor your storage consumption:

  1. Navigate to Storage in your app.
  2. View the usage bar at the top:
    • Used: Current storage used
    • Total: Your storage quota
    • Percentage: Usage percentage

Search Across Buckets​

Find files across all buckets:

  1. Navigate to Storage in your app.
  2. Click Search Files.
  3. Enter your search term.
  4. View results from all buckets.

Configuration​

Bucket Fields​

FieldDescriptionRequired
NameDisplay nameYes
SlugUnique identifierAuto-generated
DescriptionPurpose of bucketNo
PublicPublic accessibilityNo

File Upload Limits​

LimitValue
Maximum file size100 MB
Files per upload100

Accessing Files Programmatically​

Files can be accessed via URLs:

# Public bucket
https://storage.taruvi.cloud/{bucket-slug}/{filename}

# Private bucket (requires auth)
https://api.taruvi.cloud/storage/{bucket-slug}/{filename}

Limits​

ResourceLimit
Buckets per app20
Files per bucket10,000
Storage quotaVaries by plan
File size100 MB
info

Need higher limits? Contact support to discuss your requirements.

Troubleshooting​

Upload fails​

Problem: File upload fails with an error.

Solution:

  1. Check the file size is under 100 MB.
  2. Verify you have sufficient storage quota.
  3. Ensure the file type isn't blocked.
  4. Try a different browser or network.

File not accessible​

Problem: Cannot access a file URL.

Solution:

  1. Verify the bucket is public (for public URLs).
  2. Check the file path is correct.
  3. Ensure the file hasn't been deleted.
  4. Verify authentication for private buckets.

Storage quota exceeded​

Problem: Cannot upload because storage is full.

Solution:

  1. Delete unused files.
  2. Delete old or temporary files.
  3. Upgrade your plan for more storage.
  4. Contact support for temporary increase.

Last Updated: January 2025