Sources are the core concept in FileBrowser - each source represents a file system location users can access.

Basic Configuration

Single Source

YAML 
1
2
3
4
5
6
7

server:
  sources:
    - path: "/path/to/files"
      config:
        defaultEnabled: true
auth:
  adminUsername: admin

When only one source is configured, source paths will be available at http://your-server/files/path/to/file.

Multiple Sources

YAML 
1
2
3
4
5
6
7
8
9

server:
  port: 80
  sources:
    - path: "/path/to/source1" # enabled for all users
      name: "My Files"
      config:
        defaultEnabled: true
    - path: "/path/to/source2" # not default enabled!
      name: "Secured Files"

When multiple sources are configured, source paths include the souree name. For example http://your-server/files/My%20Files/path/to/file.

Common Patterns

Personal User Directories

Creating user directories for each user where

YAML 
1
2
3
4
5
6
7

server:
  sources:
    - path: "/home/users"
      config:
        defaultEnabled: true
        createUserDir: true
        #defaultUserScope: "/" # when createUserDir is false

Shared + Personal

YAML 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10

server:
  sources:
    - path: "/shared/common"
      name: "Shared Files"
      config:
        defaultEnabled: true
    - path: "/shared/users"
      name: "My Files"
      config:
        private: true

Next Steps