Browse and import files from your S3 (and compatible) storage

Overview

The S3 Browser allows you to connect to Amazon S3 or any S3-compatible storage service (MinIO, Wasabi, Backblaze B2, etc.) and browse, download, or import files directly into your Razuna workspace.

Getting Started

Creating an S3 Connection

Browsing Your S3 Storage

The S3 Browser interface includes:

Breadcrumb Navigation

• Shows your current location in the folder hierarchy
• Click any folder name in the breadcrumb to jump back to that level
• The home icon returns you to the bucket root

Folder and File Counts

• Display badges showing the number of folders and files in the current directory
• Blue badge: folder count
• Green badge: file count

Connection Information

• Connection name displayed in the top-right corner
• Loading indicator when fetching data
• Logs link to view import history

Folder Structure

• Folders appear first, marked with a yellow folder icon
• Files appear after folders with appropriate file type icons
• Click any folder to navigate into it

File Information

For each file, you can see:

• Name: File name (truncated to 60 characters if longer)
• Size: Human-readable file size
• Modified: Last modification date
• Actions: Download and import buttons

Pagination

When a folder contains more than 1,000 items:

• The first 1,000 items are displayed
• A Load More button appears at the bottom
• Click to load the next batch of items

Selecting Files and Folders

Individual Selection

• Each file and folder has a checkbox on the left
• Click the checkbox to select that item
• Selected items are highlighted

Select All

• Use the checkbox in the table header to select/deselect all visible items
• This only affects items currently displayed on the page

Selection Bar

When items are selected, a floating action bar appears at the bottom showing:

• Number of items selected
• Clear Selection button
• Download button (files only)
• Import to Razuna button

Importing to Razuna

Single File Import

1. Locate the file you want to import
2. Click the cloud download icon in the Actions column
3. Confirm the import in the dialog
4. The file will be queued for import

Bulk Import

Folder Import

When you import a folder:

• The entire folder structure is recreated in Razuna
• All subfolders are created automatically
• All files within the folder and subfolders are imported
• Folder permissions are inherited from the parent folder in Razuna
• No limit on the number of folders or depth

Duplicate Handling

By default, Razuna checks for duplicates using file checksums:

• If a file with the same checksum already exists, it will be skipped
• Enable "Allow Duplicates" to import regardless of existing files
• This prevents accidental re-imports of the same content

Import Location

All imported files are placed in:

• Your workspace's "All Files" root folder
• Folder structures are preserved under the root
• You can move files to other folders after import

Import Limits

Downloading Files

Single File Download

• Click the download icon next to any file
• The file will download directly to your computer
• Downloads are streamed from S3, not stored on Razuna servers

Bulk Download

• Select multiple files (not folders)
• Click the Download button in the selection bar
• Files will download sequentially with a 500ms delay between each
• This prevents browser limitations on simultaneous downloads

Viewing Import Logs

Accessing Logs

• Click the Logs link at the top of the S3 Browser
• A modal window will open showing your import history

Log Information

For each imported file, you can see:

• Date/Time: When the file was imported
• File Name: Name of the imported file
• Folder: Destination folder in Razuna
• User: Who initiated the import
• Checksum: File hash for duplicate detection

Log Organization

Logs are grouped by time period:

• Today: Files imported today
• Yesterday: Files imported yesterday
• Older: Files from previous days, grouped by date

Pagination

• Logs are displayed 50 entries per page
• Use the Previous/Next buttons to navigate pages
• Total count shown at the top (e.g., "Showing 1-50 of 1,234 entries")

Tips & Best Practices

Performance Tips

Organization Tips

• Keep related files in folders on S3 for easier bulk imports
• Use descriptive folder names that match your Razuna organization
• Import folder structures rather than flattening everything

Security Best Practices

• Use IAM users with restricted permissions for S3 connections
• Grant only s3:GetObject and s3:ListBucket permissions
• Regularly rotate access keys
• Use different connections for different buckets/projects

Troubleshooting

Connection Issues

Cannot connect to S3

• Verify that your access key and secret key are correct
• Check that the bucket name is spelled correctly
• Ensure the endpoint URL is correct for your provider
• Confirm your IAM user has the necessary permissions

Empty Folder Appears Populated

• The folder may contain only "folder marker" objects (keys ending in /)
• These are skipped during display
• This is normal S3 behavior

Import Issues

Import Seems Stuck

• Check the Import Logs to see if files are being processed
• Large files may take time to transfer
• The import runs in the background via the job queue
• Refresh the logs to see updated progress

Some Files Didn't Import

• Check Import Logs for error messages
• Verify files weren't skipped due to duplicate checking
• Ensure file permissions allow access
• Check if the file size exceeds any storage quotas

Folder Structure Not Created

• This was a known issue in earlier versions
• The system now scans up to 50,000 files to discover all folders
• For folders with more files, contact support

Browser Crashes When Browsing

• This issue has been fixed in the latest version
• Clear your browser cache and reload
• Close other tabs to free up memory
• Use Chrome or Firefox for the best performance.

Slow Loading

• Large folders (1000+ items) take longer to load
• Network latency affects S3 response times
• Use the Load More button to paginate large directories

Getting Help

If you encounter issues not covered here:

• Check the Import Logs for detailed error messages
• Note the exact error message and steps to reproduce
• Contact Razuna support with your workspace ID and connection name
• Include screenshots if helpful