Upload

License: PRO+ (Professional Edition or higher)
Plugin Type: File Action
Author: Diskover Data, Inc.

Overview

The Upload file action allows you to upload files directly to directories that have been indexed by Diskover. When you select a directory in the Diskover web interface and trigger the upload action, you're presented with a simple file upload form. The selected file is validated for security, processed, and written to the target directory.

This file action is designed for uploading small amounts of smaller files—think individual documents, configuration files, or other lightweight assets that need to be placed into your indexed storage infrastructure.

Key Features:

• Direct Upload to Indexed Storage - Upload files to any directory visible in Diskover without needing separate file system access

• Security Validation - Automatic file type checking to prevent unauthorized file types from being uploaded

• Session Integration - Uses your existing Diskover authentication for secure operations

• Automatic Cleanup - Temporary files are removed after processing

Use Cases

Document Management

Upload PDFs, office documents, text files, and other business documents to organized directory structures. Common scenarios include:

• Adding new contracts, reports, or documentation to project folders

• Uploading revised versions of existing documents

• Distributing approved documents to shared storage locations

Media Asset Placement

Place smaller media assets like thumbnails, proxy files, or metadata sidecar files into your media storage:

• Upload EDL or XML files to project directories

• Add thumbnail images for media organization

• Place configuration or metadata files alongside media assets

Administrative File Distribution

Administrators can use this action to distribute configuration files, documentation, or other supporting files to specific locations within indexed storage without needing direct filesystem access.

Understanding File Type Filtering

The Upload file action includes a security layer that validates files before they're written to storage. This validation uses MIME type detection—a method of identifying file types based on their actual content rather than just their file extension.

Why MIME Type Filtering Matters

When you upload a file, the system examines the file's content to determine what type of file it actually is. This prevents scenarios where someone might rename a potentially harmful file (like an executable) to look like a harmless document.

Default Restrictions

By default, the Upload file action blocks certain file types that are commonly associated with security risks or are inappropriate for document-focused workflows:

• Image files - JPEG, PNG, GIF, BMP, WebP, TIFF, SVG, HEIF/HEIC, and icons

• Executable files - Windows executables (.exe, .dll)

• Archive files - ZIP, TAR, and GZIP compressed files

Your administrator can customize these restrictions based on your organization's requirements. If you encounter a "file type cannot be uploaded" error for a legitimate file, contact your Diskover administrator.

Requirements

Diskover Requirements:

• Diskover version with file action support enabled

• PRO+ (Professional Edition) license or higher

• Active user session with appropriate permissions

Infrastructure Requirements:

• Celery task worker with write access to target directories

• Network connectivity between Diskover web server and task workers

Installation

The Upload file action is installed by your Diskover administrator. Installation involves deploying the file action package and its Python dependencies to your Diskover environment.

For detailed installation steps, administrators should refer to the Diskover Documentation Portal.

After installation, the administrator will:

1. Install the Upload file action package

2. Install required Python dependencies (Pillow, python-magic, PyMuPDF)

3. Restart the Diskover Admin and Celery services

4. Configure file type restrictions as needed

Configuration

Configuration is managed by administrators through the Diskover Admin interface.

Location: Diskover Admin Panel → Configuration → Plugins → File Actions → Upload

Default Forbidden File Types:

The default configuration blocks common image formats, executables, and archive files. Administrators can customize this list based on organizational requirements.

Configuration Example: Document-Only Uploads

For environments where only business documents should be uploaded:

forbidden_mime_types:
  - image/jpeg
  - image/png
  - image/gif
  - application/x-msdownload
  - application/zip
  - application/x-tar
  - application/gzip

Configuration Example: Allowing Image Uploads

For workflows that require image uploads, administrators can remove image MIME types from the forbidden list while keeping executable and archive restrictions in place.

Usage Guide

Selecting a Target Directory

1. Navigate to your desired index in the Diskover web interface

2. Use search or browse to locate the target directory where you want to upload files

3. Select the directory by clicking its checkbox in the file browser

4. Click the Actions menu in the toolbar

5. Select Upload from the available file actions

Important: The Upload file action works with directories only. You must select a directory as the upload destination, not individual files.

Uploading a File

1. After selecting the Upload action, the upload form appears

2. Review the destination path displayed at the top to confirm you've selected the correct target directory

3. Review the assigned worker to confirm a task worker is available

4. Click Choose File (or drag and drop) to select a file from your computer

5. Click Upload to begin the transfer

Monitoring Upload Progress

1. After clicking Upload, the system processes your file

2. Upon completion, you're redirected to the task result page

3. Review the result message:

   • Success: "File {filename} saved successfully at {path} with MIME type {type}"

   • Error: A specific error message describing what went wrong

Understanding Upload Validation

When you upload a file, the system performs several checks:

1. Session Verification - Confirms you have an active Diskover session

2. File Presence - Verifies a file was selected

3. Content Analysis - Examines the file to determine its actual type

4. Type Validation - Compares the detected type against the allowed list

5. Transfer - Sends the file to the task worker for writing to storage

If any check fails, you'll receive a clear error message explaining what happened.

Best Practices

File Size Considerations:

The Upload file action is designed for smaller files. For best results:

• Upload individual files rather than large batches

• Keep file sizes reasonable for your network conditions

• For large files or bulk transfers, consider using dedicated file transfer tools

Workflow Tips:

• Verify the destination path before uploading to avoid placing files in the wrong location

• Use descriptive filenames that follow your organization's naming conventions

• If you need to upload multiple files to the same location, upload them one at a time

Security Best Practices:

• Be aware of your organization's file type restrictions

• If a legitimate file is rejected, contact your administrator rather than attempting workarounds

• Verify uploaded files appear in the expected location after the operation completes

Troubleshooting

Debug Logging

If you're experiencing persistent issues, administrators can enable debug logging for troubleshooting:

• Diskover Admin logs: /var/log/diskover/diskover-admin.log

• Celery task worker logs: /var/log/celery/worker.log

• Web server logs: /var/log/nginx/error.log

Common Error Messages

Support

• Documentation: https://docs.diskoverdata.com

• Support Portal: https://support.diskoverdata.com

Last Updated: January 2026
Diskover Data, Inc.