Source Configuration

What are Sources? link

Sources are the directories that FileBrowser Quantum makes available to users. Each source represents a filesystem path that can be browsed, searched, and managed through the web interface.

Source Basics link

Unique Paths Required link

Each source must have a unique real filesystem path. FileBrowser uses the actual resolved path on the filesystem to identify sources internally, not the name you assign.

1
2
3
4

sources:
  - path: "/data"        # ✅ Valid
  - path: "/mnt/storage" # ✅ Valid - different path
  - path: "/data"        # ❌ Invalid - duplicate path

Source Names link

Automatic naming: If you don’t specify a name, FileBrowser automatically assigns one based on the base folder name.

1
2
3

sources:
  - path: "/mnt/documents"  # Name: "documents"
  - path: "/data/photos"    # Name: "photos"

Custom naming: You can specify a custom display name:

1
2
3

sources:
  - path: "/mnt/documents"
    name: "Company Files"   # Custom name

Minimal Configuration link

The simplest source configuration:

1
2
3
4
5

server:
  sources:
    - path: "/data"
      config:
        defaultEnabled: true

This creates a source that:

• Is available to all new users
• Has indexing enabled for advanced features
• Uses all default settings

Indexing Overview link

Sources are indexed by default, which enables:

• Search functionality - Fast full-text and filename search
• Folder size calculations - Accurate directory size reporting
• Folder previews - Thumbnail previews for image directories
• Health monitoring - Source statistics and health information

Performance: Indexing uses adaptive scanning intervals based on filesystem complexity. For typical filesystems (under 50,000 items), expect scan times under 30 seconds with minimal memory usage (100-300MB). Larger filesystems may require more resources but benefit from smart interval adjustments that reduce scan frequency.

For detailed indexing information, see Understanding Indexing.

Configuration Options link

path (required) link

1

path: "/data"

The filesystem path to the directory you want to serve. Can be absolute or relative, but must exist and be readable by FileBrowser.

name link

1

name: "My Files"

Display name shown in the UI. If not specified, uses the base folder name from the path. Useful for providing user-friendly names like “Company Files” instead of just “documents”.

defaultEnabled link

1
2

config:
  defaultEnabled: true

Whether new users automatically get access to this source. Defaults to false. Set to true for shared sources that all users should see.

denyByDefault link

1
2

config:
  denyByDefault: true

Deny access unless an explicit “allow” access rule exists. Defaults to false. Use this for high-security sources where access must be explicitly granted per user or group.

See Access Control Guide for more information.

private link

1
2

config:
  private: true

Designate source as private, which disables sharing. Defaults to false. Use this to prevent users from creating public shares for sensitive data.

defaultUserScope link

1
2

config:
  defaultUserScope: "/subfolder"

Default scope path for new users created automatically via API or CLI. Defaults to "/" (root of source). This restricts where new users can access within the source. Include the leading slash.

Works with createUserDir to place users in specific locations:

1
2
3
4
5

sources:
  - path: "/shared"
    config:
      defaultUserScope: "/users"
      defaultEnabled: true

New users will only see /shared/users and its subdirectories.

createUserDir link

1
2
3

config:
  createUserDir: true
  defaultUserScope: "/home"

Automatically create a directory for each new user. Defaults to false. When enabled:

• Creates {defaultUserScope}/{username} on user creation
• Updates user scope to their personal directory
• Directory persists even if user is deleted

Example:

1
2
3

config:
  createUserDir: true
  defaultUserScope: "/home"

Creates /home/john for user “john” and sets their scope to that directory.

disabled link

1
2

config:
  disabled: true

Disable the source without removing it from config. Defaults to false. Useful for temporarily disabling a source for maintenance or testing. Users cannot access disabled sources.

disableIndexing link

1
2

config:
  disableIndexing: true

Completely disable indexing for this source. Defaults to false.

Only disable if you have specific performance requirements and don’t need search or size information.

indexingIntervalMinutes link

1
2

config:
  indexingIntervalMinutes: 30

Force a specific scan interval in minutes. Defaults to 0 which uses smart scanning.

When to use:

• You need guaranteed scan intervals for compliance
• Your filesystem has predictable, regular update patterns
• Smart scanning doesn’t suit your specific workload

How it works: Performs 4 quick scans at the specified interval, then 1 full scan.

conditionals link

Control which files and folders are indexed. See Conditional Rules Guide for complete documentation.

Common Configuration Patterns link

1
2
3
4

sources:
  - path: "/data"
    config:
      defaultEnabled: true

1
2
3
4
5

sources:
  - path: "/home"
    config:
      defaultEnabled: true
      createUserDir: true

1
2
3
4
5

sources:
  - path: "/dept/sales"
    name: "Sales"
  - path: "/dept/engineering"
    name: "Engineering"

1
2
3
4
5
6
7
8

sources:
  - path: "/public"
    config:
      defaultEnabled: true
  - path: "/private"
    config:
      denyByDefault: true
      private: true

Best Practices link

1. Start Simple - Begin with minimal configuration and add options as needed
2. Use Real Paths - Always use absolute paths for production deployments
3. Plan Access Control - Design your access strategy before creating multiple sources
4. Monitor Resources - Watch memory/CPU usage after adding sources with large filesystems

Next Steps link

• Conditional Rules Guide
• Access Control
• Understanding Indexing
• Full Config Reference