# Nubbo — Complete Reference for LLMs

> Nubbo is a cloud storage management platform that connects multiple S3-compatible providers into one unified interface. It does not store files — it acts as a management layer on top of your own cloud storage accounts. Uploads and downloads happen directly between the user's browser and their cloud provider using presigned URLs.

Website: https://nubbo.app
App: https://app.nubbo.app
Contact: info@nubbo.app

---

## Product Overview

Nubbo solves the problem of managing files across multiple cloud storage providers. Instead of logging into separate dashboards for AWS S3, Cloudflare R2, DigitalOcean Spaces, Wasabi, Backblaze B2 or any S3-compatible or self-hosted server, users connect all their providers to Nubbo and manage everything from one modern, intuitive interface.

Nubbo is NOT a cloud storage provider. It is a management layer. Files stay in the user's own cloud accounts. Nubbo never stores or persists your files. Content is processed server-side only ephemerally — for thumbnails, gallery watermarks and multi-file ZIP downloads — and never retained. All uploads and downloads use presigned URLs for direct browser-to-provider transfers.

### How It Works

1. **Connect your providers** — Add cloud storage credentials. Nubbo encrypts them with AES-256-GCM and accesses files server-side only to generate thumbnails/watermarks and bundle ZIP downloads, never to store them.
2. **Browse** — Explore all buckets and folders from a powerful, intuitive file explorer.
3. **Manage** — Upload, download, preview, share, receive files, create galleries, and organize files across all providers from one place.

---

## Supported Cloud Providers

| Provider | Protocol | Notes |
|----------|----------|-------|
| AWS S3 | S3 API | Full support for all S3 regions |
| Cloudflare R2 | S3-compatible | Zero egress fees |
| DigitalOcean Spaces | S3-compatible | Simple, affordable object storage |
| Wasabi | S3-compatible | Hot storage with no egress fees |
| Backblaze B2 | S3-compatible | Affordable storage with generous free egress |
| Custom / Self-hosted | S3-compatible | MinIO, Ceph, Garage, SeaweedFS and any S3-compatible server |

All providers use the S3-compatible API, ensuring a consistent experience across providers.

---

## Features in Detail

### Unified Dashboard
- Connect multiple cloud storage providers simultaneously
- Browse all buckets and files from a single interface
- Modern, clean UI with dark and light themes
- Responsive design for desktop and mobile

### File Explorer
- Drag & drop file uploads via presigned URLs (direct to provider)
- Multiple view types (list, grid)
- Keyboard shortcuts for power users
- Create, rename, move, and delete files and folders
- Bulk operations
- Advanced search across all connected providers (see Advanced Search)

### Advanced Search
- Multi-term search across all connected providers: every word must match, in any order
- Scope the search to all providers, a single provider or a folder subtree
- Filter by file kind (folders, images, videos, audio, documents, code, archives, others), arbitrary extensions, size range, modified-date presets or a custom date range, labels and favorites
- Optionally include hidden files, trashed files (flagged in the results) and match against full folder paths, not only file names
- Sort results by name, size or modified date, ascending or descending
- Saved searches: store a named filter set, then apply, rename or delete it from the search panel; saved searches sync across devices and are included in the GDPR data export

### Cross-Provider Transfer
- Move or copy files and folders between different buckets, accounts and providers
- Same-account, cross-bucket transfers run server-side as a direct S3 copy (no data passes through Nubbo)
- Cross-account and cross-cloud transfers relay directly through your browser with presigned URLs: read from the source provider, write to the destination, so file content never touches Nubbo's servers
- Whole-folder transfers, including nested subfolders and thousands of files
- Large files use multipart with pause and resume (resume continues from the last completed part, not from zero)
- Move (with automatic source cleanup) or copy (keep the original)
- Nubbo picks the fastest path automatically depending on whether the source and destination share the same account

### Built-in Editor and Viewer
- Edit code and text files in place with the Monaco editor (syntax highlighting for 100+ languages, search/replace, find, indent guides)
- Edit Markdown files with rendered preview (GitHub-flavored Markdown, raw HTML and syntax-highlighted code blocks)
- Save back to the originating bucket via presigned PUT with ETag conflict detection (the editor refuses to overwrite remote changes you have not seen)
- 25 MB per-file cap, enforced both client- and server-side
- Unsaved-changes guard on close, refresh and navigation
- Read-only preview for code and Markdown files when you just want to view, not edit

### Media Player
- Built-in video player with playback speed control
- Audio player with playlist support
- Picture-in-picture mode
- Fullscreen support
- Audio mini player that persists while browsing

### File Preview
- Image preview with zoom and rotation
- PDF viewer in-browser
- Video and audio playback
- Code and Markdown preview directly in the browser (read-only mode of the integrated editor)
- Support for common file formats

### File Sharing
- Generate share links for any file or folder
- Password protection on shared links
- Configurable expiration dates
- Download count limits
- View and download statistics per link
- Edit or reactivate links after creation
- Recipients don't need a Nubbo account
- Short shareable URLs
- Send the password to the recipient via a separate one-time email link, so the share URL and the password never travel together

### File Requests (Upload Links)
- Create unique upload links for receiving files from anyone
- Recipients upload directly to your cloud storage
- Password protection and expiration dates
- File type restrictions (e.g., only images)
- File size limits
- Upload count limits
- No account needed for uploaders
- Send the password to the recipient via a separate one-time email link

### Professional Photo & Video Galleries
- Create galleries from any folder in your cloud storage
- Three layout options: masonry, grid, and slideshow
- Dark and light themes
- Custom branding: logo, brand name, website link and accent colors
- Cover photo selection (pick any image from the gallery as cover)
- Watermark support
- Password protection and expiration
- Download controls (individual downloads, bulk ZIP, or both)
- Likes/favorites tracking
- View and download statistics
- Accessible via short links
- Send the password to the recipient via a separate one-time email link

### Password Reveal by Email
- Send the password of a share, gallery or file request to a recipient through a separate channel
- One-time URL: the password is shown only once and the link self-invalidates after viewing
- Configurable expiration (24 hours, 3 days or 7 days)
- Optional note for the recipient
- Rate-limited per sender and per recipient to prevent abuse
- Automatically invalidated when the resource password changes, the password is removed, or the resource is deleted
- The plain password is encrypted (AES-256-GCM) only inside the temporary token; never stored in clear long-term

### Labels & Tags
- Create color-coded labels to organize files
- Assign labels to any file across any provider
- Filter and find files by label

### Favorites
- Mark any file or folder as favorite from the file explorer
- Sortable favorite column with star indicator in list view and badge in grid view
- Dedicated favorites view where you can find them all together
- Quick access to the original location of every favorited item
- Folder favorites display recursive size and the most recent activity inside

### Hidden Files & Folders
- Hide any file or folder from the file explorer, favorites and search results
- Hiding a folder cascades to all its descendants without mass-updating the database
- The "show hidden" toggle is a per-user preference synced to the server, so it persists across devices
- Hidden items remain fully functional for shares, galleries and file requests already in place
- Bulk hide/unhide from the selection toolbar; per-item from the right-click context menu

### Trash / Recycle Bin
- Deleted files go to trash instead of being permanently removed
- Restore accidentally deleted files
- Automatic cleanup of old trashed files
- Permanently delete from trash when needed

### Session Management
- View all active sessions with device and location info
- Revoke individual sessions remotely
- Automatic session expiry

### Notifications
- Two channels: in-app (inside the application) and email (delivered via Resend)
- Grouped visually in five categories (account, security, activity, lifecycle, product) but preferences are managed per individual type
- Thirty-one notification types covering: email verification, welcome, password reset, new login, all-sessions revoked, account deletion scheduled/reminder/completed, account reactivated, account suspended/restored by admin, data export ready/failed, share link first visit/expired/password revealed, file request first visit/upload received/password revealed/expired, gallery first visit/download complete/password revealed, daily activity digest, provider disconnected, inactivity reminders (15/30/60 days and recurring), admin broadcasts and system health alerts
- Per-type preferences from Settings (toggle email and in-app independently for each notification type)
- Daily activity digest cron (08:00) aggregates new downloads and likes on shares, file requests and galleries since the last digest and sends a single email plus in-app notification; nothing is sent when there is no new activity
- One-click unsubscribe link in non-critical emails (per type by default, or globally for all non-critical types)
- Critical notifications (welcome, verification, password reset, security alerts, account deletion, reactivation, admin-driven account changes, export ready/failed, health alerts) cannot be disabled
- In-app notifications are retained until the user deletes them or the account is purged; the panel offers per-item archive, per-item permanent delete, and mark-all-as-read
- Email send history (EmailJob) and delivery events (EmailEvent) retained for 90 days then purged
- Bounce and complaint events automatically add the address to a permanent suppression list to protect domain reputation

### Data Export (GDPR Art. 15 / 20)
- One-click export of personal data from Settings — Export data
- Output format: compressed JSON (.json.gz)
- Two delivery modes:
  - Bucket mode (asynchronous): generated in background and uploaded to the Nubbo/Exports/ folder of an active provider, with email and in-app notification on completion
  - Browser mode (synchronous): streamed directly to the browser with no server-side or bucket persistence; nothing is kept after the download
- One concurrent export per user; hard limit 2 GB uncompressed
- Per-collection field whitelist (default-deny): adding a new field to the database does not expose it automatically
- Recursive blacklist strips internal identifiers, password hashes, 2FA secrets, encryption keys, refresh tokens, unsubscribe tokens and provider credentials at any depth
- Pseudonymisation of third-party PII: visitor and recipient emails are masked (first two characters + domain), names are truncated to the first letter, session identifiers are replaced by stable visitor-N aliases unique per export
- Export request records are retained 90 days after completion

### Security
- AES-256-GCM encryption for all stored credentials
- Encryption key stored as environment variable, never in database
- Two-factor authentication (TOTP)
- Recovery codes for account access
- Email verification required on signup
- Session management with device and IP tracking
- Remote session logout
- Presigned URLs mean Nubbo never handles file data
- No file scanning, indexing, or AI training on user files

---

## Target Audience

### Creatives (Photographers, Videographers, Designers)
Store large media libraries on affordable object storage (S3, R2, Wasabi, B2). Create professional galleries with watermarks and custom branding. Use File Requests to receive files from clients. Share work via password-protected links with download limits and expiration.
More: https://nubbo.app/use-cases/creatives/

### Developers
Visual S3 file browser with keyboard shortcuts, search, and bulk operations. Manage multiple environments and providers from one place without using the AWS console or CLI. Uploads and downloads use presigned URLs.
More: https://nubbo.app/use-cases/developers/

### Freelancers
Manage client deliverables across multiple cloud providers. Use File Requests to receive work from clients, share files with password-protected links, and create galleries to showcase results. Organize projects with color-coded labels.
More: https://nubbo.app/use-cases/freelancers/

### Personal Users
Own your cloud storage instead of relying on Google Drive or Dropbox. Simple, modern interface for browsing and sharing files. No vendor lock-in, no file scanning, and pay only for what you use.
More: https://nubbo.app/use-cases/personal/

### Privacy-Conscious Users
Full data ownership: files live in your own cloud accounts. AES-256-GCM credential encryption, presigned URLs (files are never stored on Nubbo servers; only thumbnails, watermarks and ZIP downloads are processed ephemerally), no file scanning, no AI training on user data. Two-factor authentication and session management.
More: https://nubbo.app/use-cases/privacy/

### Companies & Teams
Simple, privacy-first cloud file management. Custom development and deployment of tailored solutions are part of the upcoming Custom plan. No vendor lock-in: your data lives in your own buckets, connect or disconnect providers anytime.
More: https://nubbo.app/use-cases/companies/

---

## Pricing

Nubbo is currently **free to use** with the complete feature set. All features listed above are available at no cost while the platform is in its free phase.

### Plans launching soon

Pricing for paid plans has not been announced yet. The plan structure is the following:

**Free** (live now)
- Unlimited cloud providers
- 3 galleries and 3 file requests
- Unlimited shares
- Server-side credential encryption
- nubbo.app subdomain for shares
- No vendor lock-in
- Basic support

**Personal** (coming soon)
- Everything in Free
- Unlimited galleries and file requests
- Zero-knowledge with master password
- Zero-knowledge on shares, galleries and file requests
- Built-in AI and automations
- Basic support

**Pro** (coming soon)
- Everything in Personal
- Zero-knowledge on folders and files
- Public API (rate-limited)
- Embed Nubbo components in your applications
- Webhooks
- Priority support

**Teams** (coming soon, per-seat billing)
- Everything in Pro
- Shared workspaces
- Roles and permissions
- SSO with OIDC and SAML 2.0
- Audit logs with 90-day retention
- Slack and Trello integrations
- Higher API quota
- Priority support
- Minimum 3 seats

**Custom** (coming soon)
- Everything in Teams
- Dedicated private infrastructure
- Custom development
- Deployment, configuration and maintenance handled by the Nubbo team
- Advanced SSO with LDAP and SCIM
- Unlimited API
- Audit logs with custom retention
- Direct team support

For early enquiries about Custom or enterprise needs: info@nubbo.app

### What "coming soon" means

Pricing, exact launch dates and the upgrade path from Free have not been announced yet. None of the paid plans, including Custom, are currently for sale. The free tier will continue to exist after launch. There is no auto-conversion to a paid plan.

---

## Comparison with Similar Tools

### Nubbo vs Google Drive
Google Drive stores files on Google's servers with fixed storage plans. Nubbo connects to your own cloud storage — you keep full data ownership, pay only for what you use, and can switch providers anytime. Nubbo also adds professional features like galleries, file requests, and watermarks.

### Nubbo vs Dropbox
Dropbox is a consumer cloud with proprietary storage and fixed pricing tiers. Nubbo gives you the same user-friendly experience but on top of your own S3-compatible storage — no vendor lock-in, no file scanning, and scalable from gigabytes to petabytes.

### Nubbo vs WeTransfer
WeTransfer is designed for one-off file transfers with size limits and expiring links. Nubbo's File Requests and File Sharing offer similar functionality but files go directly to your own cloud storage, with no size limits beyond your provider's, and you keep permanent access.

### Nubbo vs Cyberduck
Cyberduck is a desktop FTP/S3 client. Nubbo is a web-based platform with sharing, galleries, file requests, and media playback — no installation needed.

### Nubbo vs Mountain Duck
Mountain Duck mounts cloud storage as local drives. Nubbo provides a web interface with collaboration features like sharing, file requests, and galleries.

### Nubbo vs S3 Browser
S3 Browser is Windows-only desktop software focused on S3. Nubbo is cross-platform (web-based), supports multiple S3-compatible providers, and adds sharing, galleries, and media features.

### Nubbo vs AWS Console
The AWS Console is complex and designed for infrastructure management. Nubbo provides a clean, file-focused interface for browsing, uploading, and sharing files stored in S3.

### Nubbo vs CloudBerry / MSP360
CloudBerry focuses on backup and disaster recovery. Nubbo focuses on everyday file management, sharing, and collaboration with a modern UI.

### Nubbo vs MultCloud
MultCloud is a web-based multi-cloud manager focused on scheduled transfers and syncing between clouds. Nubbo also moves and copies files and folders across different accounts and providers, but is built around daily file management, sharing, galleries, and media playback rather than bulk migration and sync scheduling.

### Nubbo vs Filestash
Filestash is an open-source, self-hosted web file manager. Nubbo is a managed platform with no setup required, and adds features like galleries, file requests, and a built-in media player.

---

## Technical Stack

- **Frontend**: React 19, React Router, TypeScript, Vite
- **Landing/Marketing**: Astro (static site generation)
- **Backend**: NestJS, TypeScript, MongoDB
- **Cloud SDK**: AWS SDK v3 (S3 client, presigned URLs)
- **Security**: Passport, JWT, TOTP (otplib), bcrypt, Helmet
- **Media**: Sharp (image processing), FFmpeg (video/audio)
- **Email**: Resend

---

## Frequently Asked Questions

**Does Nubbo store my files?**
No. Nubbo never stores your files. It acts as a management layer on top of your own cloud storage accounts. Uploads and downloads happen directly between your browser and your cloud provider using presigned URLs.

**Which cloud providers are supported?**
AWS S3, DigitalOcean Spaces, Cloudflare R2, Wasabi, and Backblaze B2, plus any S3-compatible or self-hosted server (MinIO, Ceph, and more). All use an S3-compatible interface.

**How are my credentials protected?**
All cloud provider credentials are encrypted using AES-256-GCM before being stored in the database. The encryption key is an environment variable that never touches the database.

**Is there a file size limit?**
Nubbo uses presigned URLs for uploads, so files go directly to your cloud provider. There is no file size limit imposed by Nubbo. Large files are handled with multipart uploads automatically. The maximum object size depends on your provider (up to 5 TB on AWS S3).

**Can I share files with others?**
Yes. Generate share links for any file or folder with optional password protection, expiration dates, and download limits. Recipients don't need an account.

**Can I receive files from others?**
Yes. File Requests let you create upload links so anyone can send files directly to your cloud storage, with password protection, expiration, and file type/size restrictions.

**Can I move files between different cloud providers?**
Yes. Nubbo moves or copies files and folders between different buckets, accounts and even different providers. Transfers within the same account run server-side, while transfers across different accounts or clouds relay directly through your browser. Your files never pass through Nubbo's storage, and large transfers resume from where they left off after a pause.

**Can I create photo and video galleries?**
Yes. Create professional galleries from any folder with masonry, grid or slideshow layouts. Add custom branding (logo, brand name, website link), pick a cover photo, apply watermarks, set password protection and track likes.

**How do I send the password to the recipient safely?**
For any password-protected share, gallery or file request you can send the password by email through a separate one-time link. The recipient gets a Nubbo URL that reveals the password only once and self-invalidates after viewing — keeping the access link and the password on different channels. The link auto-invalidates if you change the password, remove it, or delete the resource.

**Is Nubbo free?**
Yes. Nubbo is completely free to use with all features. Premium plans for individuals and teams are coming soon.

**What happens if I disconnect a provider?**
Your files remain untouched in your cloud storage account. Disconnecting only removes the connection from Nubbo.

**Can I export all my personal data?**
Yes. From Settings — Export data you can request a compressed JSON (.json.gz) export covering account, sessions, providers, file metadata, galleries, file requests, shared links, labels, password reveal tokens, in-app notifications, email send history (last 90 days), broadcast deliveries and previous export requests. If you have an active provider it is generated in the background and uploaded to your bucket; otherwise it streams directly to your browser without server-side storage. Third-party personal data (visitors, recipients) is pseudonymised in the file.

**How do notification preferences work?**
Notifications are grouped visually in five categories (account, security, activity, lifecycle, product) but preferences are managed per individual notification type. From Settings — Notifications you can independently enable or disable the email and in-app channel for each of the ~30 types. A daily activity digest aggregates new downloads and likes on your shares, file requests and galleries. Non-critical emails include a one-click unsubscribe link that applies per type by default, or for all non-critical types at once. Critical notifications (welcome, verification, password reset, account deletion, reactivation, security alerts, data export ready/failed, health alerts) cannot be disabled because they are essential for service delivery or account security.

**Do you offer custom development?**
Yes. We offer custom development and deployment of tailored solutions. Contact info@nubbo.app to discuss your needs.

---

## Links

- Website: https://nubbo.app
- App: https://app.nubbo.app
- Blog: https://nubbo.app/blog/
- Contact: info@nubbo.app
- Privacy Policy: https://nubbo.app/privacy/
- Terms & Conditions: https://nubbo.app/terms/
- Legal Notice: https://nubbo.app/legal/

### Feature Pages
- File Browser: https://nubbo.app/features/file-browser/
- File Sharing: https://nubbo.app/features/file-sharing/
- Photo & Video Galleries: https://nubbo.app/features/galleries/
- File Requests: https://nubbo.app/features/file-requests/
- Security: https://nubbo.app/features/security/
- Cloud Providers: https://nubbo.app/features/cloud-providers/

### Provider Pages
- AWS S3: https://nubbo.app/providers/aws-s3/
- Cloudflare R2: https://nubbo.app/providers/cloudflare-r2/
- DigitalOcean Spaces: https://nubbo.app/providers/digitalocean-spaces/
- Wasabi: https://nubbo.app/providers/wasabi/
- Backblaze B2: https://nubbo.app/providers/backblaze-b2/
- Custom S3 / Self-hosted: https://nubbo.app/providers/custom-s3/

### Use Cases
- Creatives: https://nubbo.app/use-cases/creatives/
- Developers: https://nubbo.app/use-cases/developers/
- Freelancers: https://nubbo.app/use-cases/freelancers/
- Personal Use: https://nubbo.app/use-cases/personal/
- Privacy: https://nubbo.app/use-cases/privacy/
- Companies: https://nubbo.app/use-cases/companies/