FileBrowser Upload Service - User Guide

Welcome! This guide will help you upload AI models and files to the Haiven server using the web-based FileBrowser interface.

Getting Started

Accessing the Upload Service

1. Open your web browser and navigate to: https://upload.haiven.local
2. You may see a security warning about the TLS certificate (if using self-signed certificates)
   - Click "Advanced" or "Show Details"
   - Click "Proceed to upload.haiven.local" or "Accept the Risk"
3. Enter your login credentials (provided by your administrator)
4. Click "Login"

Note: You must be on the correct network to access this service. Contact your administrator if you cannot reach the login page.

Web Interface Overview

Once logged in, you'll see the FileBrowser interface:

Left Panel - Navigation

• Shows the directory tree
• Click folders to expand/collapse
• Click a folder name to navigate into it

Main Area - File Browser

• Displays files and folders in the current directory
• Shows file sizes and modification dates
• Select items by clicking checkboxes

Toolbar (Top)

• Upload: Upload files from your computer
• New Folder: Create a new directory
• Download: Download selected files
• Delete: Remove selected files (only works in /uploads/)
• Search: Find files by name

Uploading Files

Understanding Upload Directories

Files must be uploaded to the correct location based on their type:

Method 1: Upload via Web Interface

For files under 10GB:

1. Navigate to the appropriate upload directory (see table above)
2. Click the Upload button in the toolbar
3. In the file picker dialog, select the file(s) you want to upload
4. Click "Open" or "Choose"
5. Wait for the upload to complete
   - A progress bar will show upload status
   - Do NOT close your browser during upload
   - Large files may take several minutes to hours depending on size and network speed

Tips:
- Your browser must stay open until the upload completes
- You can upload multiple files at once
- Upload will resume from the beginning if interrupted

Method 2: Drag and Drop

1. Navigate to the appropriate upload directory
2. Open your file manager (Windows Explorer, macOS Finder, etc.)
3. Drag the file from your file manager into the FileBrowser window
4. Drop it in the main file browser area
5. Wait for the upload to complete

Method 3: rsync for Large Files (10GB+)

Recommended for files larger than 10GB

If you're comfortable with the command line, rsync provides more reliable uploads for large files:

rsync -avP --progress -e 'ssh -p 25636' \
  /path/to/your/local/model.gguf \
  username@haiven:/mnt/storage/uploads/models/gguf/

Replace:
- /path/to/your/local/model.gguf - Path to your file
- username - Your username
- Adjust the destination path for different model types

Benefits of rsync:
- Resumes interrupted transfers
- Shows detailed progress
- More reliable for very large files
- Works even if your connection drops temporarily

Note: You'll need SSH access (port 25636) and your administrator must provide SSH credentials.

Browsing Existing Models

The FileBrowser also provides read-only access to view existing models and generated content:

Read-Only Directories

• /models/ - All production AI models currently in use
• /models/gguf/ - LLM models
• /models/image/ - Image generation models
• /storage/ - Generated outputs and user data

Important: You can only view and download from these directories. To upload new models, always use the /uploads/ directory.

Managing Your Uploads

Creating Folders

1. Navigate to /uploads/ or any subfolder
2. Click the New Folder button
3. Enter a folder name
4. Press Enter or click "Create"

Use this to organize your uploads (e.g., create a folder with your name or project)

Renaming Files

1. Right-click on a file in /uploads/
2. Select "Rename"
3. Enter the new name
4. Press Enter

Deleting Files

1. Select the file(s) you want to delete (checkbox on the left)
2. Click the Delete button in the toolbar
3. Confirm the deletion

Note: You can only delete files in the /uploads/ directory. Files in /models/ and /storage/ are read-only.

Downloading Files

1. Select the file(s) you want to download
2. Click the Download button
3. The file will download to your browser's download folder

What Happens After Upload

Your upload process follows these steps:

1. Upload: You upload files to the /uploads/ staging area
2. Review: The administrator reviews your uploaded files
3. Approval: Approved files are moved to the production location
   - GGUF models → /mnt/models/gguf/
   - Image models → /mnt/models/image/
4. Availability: Files become available to AI services
5. Configuration: Administrator updates service configs to use new models

Important: Files don't automatically become available after upload. An administrator must approve and configure them first.

Best Practices

File Naming

• Use descriptive names: mixtral-8x7b-instruct-q4_k_m.gguf instead of model.gguf
• Include version numbers when applicable
• Avoid spaces (use hyphens or underscores instead)
• Keep names under 255 characters

Upload Organization

• Upload to the correct subdirectory for your model type
• Create a personal folder if uploading multiple files
• Use /uploads/temp/ for testing
• Delete test files when you're done

Verify Your Upload

After uploading, verify the file was transferred correctly:

1. Check the file size matches your original file
2. Compare the last modified date
3. If sizes don't match, try uploading again

Clean Up

• Delete files from /uploads/temp/ after testing
• Remove duplicate uploads
• Ask the administrator when files can be deleted after approval

Troubleshooting

Upload Issues

Navigation Issues

Login and Access Issues

Browser Compatibility

FileBrowser works best with modern browsers:
- Chrome/Chromium (recommended)
- Firefox
- Safari
- Edge

If you experience issues, try:
1. Clearing browser cache
2. Using an incognito/private window
3. Trying a different browser
4. Disabling browser extensions

File Size Guidelines

Getting Help

Before Contacting Admin

1. Check this troubleshooting section
2. Try uploading a small test file to /uploads/temp/
3. Verify you're using the correct directory path
4. Check your network connection
5. Try a different browser

When to Contact Administrator

• Cannot log in (forgot password, account issues)
• Need SSH access for rsync uploads
• Uploaded file needs to be moved to production
• Questions about model configuration
• Permission issues
• Service is completely unavailable

What to Include When Requesting Help

• What you were trying to do
• What directory you were using
• Error messages (screenshot if possible)
• File name and size
• Browser and operating system you're using

Quick Reference

Common Upload Paths

LLM Models:           /uploads/models/gguf/
SD Checkpoints:       /uploads/models/image/checkpoints/
LoRA Models:          /uploads/models/image/loras/
Test Files:           /uploads/temp/

Access Information

• URL: https://upload.haiven.local
• SSH Port: 25636 (for rsync)
• Network: Must be on Haiven network

Remember

• Upload to /uploads/ only
• /models/ and /storage/ are read-only
• Keep browser open during uploads
• Use rsync for files over 10GB
• Contact admin after upload for approval

Need More Information?

• Technical details: See README.md in the same directory
• Administrator documentation: See deployment and configuration files
• Service status: Check https://status.haiven.local

Happy uploading!