Neblina is a client-side web application that adds transparent end-to-end encryption to cloud storage, ensuring your files remain private even from the provider.

Built on rclone's proven crypt backend, Neblina provides a web interface for existing rclone users or new users wanting encrypted cloud storage. Currently, only Google Drive is supported.

🏗️ Neblina is currently under active development. It has not undergone extensive security auditing. See roadmap for upcoming features.

• Browser-based: View and upload files just like in Google Drive - no installation required
• Battle-tested encryption: Uses rclone's original code compiled to WebAssembly - no reimplementation of encryption layer
• Rclone compatibility: Works seamlessly with existing rclone crypt remotes (some options are still in progress)
• Zero-trust archtecture: All operations execute in your browser, no requests to server after initial load - client-side everything
• Secure OAuth: Google Drive integration with short lived OAuth tokens

Try Neblina at neblina.cloud

No setup required! Uses our public Google Cloud app for OAuth authentication. Your encryption password and files never leave your browser.

• Node.js (v20 or higher)
• Go (v1.21 or higher)
• npm or yarn

1. Clone the repository:

   git clone https://github.com/your-username/neblina.git
   cd neblina

2. Install dependencies:

   npm install

3. Build the application:

   npm run build

4. Serve the built files:

   npm run preview
   # or use any static file server
   npx serve dist/

To enable Google Drive integration, you need to create your own Google Cloud project:

1. Go to Google Cloud Console
2. Create a new project or select existing one
3. Enable the Google Drive API
4. Go to Credentials → Create Credentials → OAuth 2.0 Client IDs
5. Set Application type to "Web application"
6. Add your domain to Authorized JavaScript origins (e.g., https://yourdomain.com)
7. Update the Google Client ID in your deployment

Static Hosting (Recommended):

• Deploy the dist/ folder to any static hosting service
• Examples: Netlify, Vercel, GitHub Pages, CloudFlare Pages

Docker (see below for Docker setup)

⚠️ Important: Google will show an "unverified app" warning because Neblina is an open source project without resources for verification process. This is normal and safe to proceed with.

1. Add Account: Click "Add Account" and authenticate with Google Drive
2. Create a Vault:
   • Choose a descriptive vault name
   • Click "Choose Vault Folder" to select an empty folder in your Google Drive
   • Set a strong encryption password
3. Start uploading - files are automatically encrypted before reaching Google Drive

1. Find your password: rclone obscure --reveal your-obscured-password
2. Add your Google Drive account
3. Create a vault with that password and the same folder path as your existing crypt remote

• Support for rclone's password2 (custom salt)
• Enable move operations
• Improve file grid UI
• Mobile responsive design
• Global vault search
• Password manager for vault configs
• Export/import rclone configs
• Enable using custom clients on neblina.cloud
• Disable local storage option
• Fire button

• rclone Crypt Documentation - Underlying encryption implementation
• WebAssembly Security - WASM security model

This project is licensed under the MIT License - see the LICENSE file for details.