Layout

LAYOUT

Controls what happens when a user clicks a file in the directory listing.

Supported values:

• popup (default): Opens a preview dialog. The dialog shows file metadata (for example size, timestamps, and configured hashes) and provides actions like downloading or opening the file.
• basic: Skips the dialog and starts downloading the file immediately. This is the pre-v4.0 behavior.

⚙️ Configuration

Variable	Default	Values	Details
LAYOUT	popup	basic popup	added in v3.17
OPEN_NEW_TAB	false	true false	Open file in a new tab.added in v3.2
HIGHLIGHT_UPDATED	true	true false	When a file has been changed in the last 48 hours its last modified date gets bold.added in v2.0
TRANSITION	false	true false	Show fade animation when navigating.added in v3.3.2
TITLE	dir-browser	<string>	Browser tab title prefix (the current path is appended).added in v4.3

How to set configuration options

Set the environment variables when starting the container.
Use docker run...

• ...with -e LAYOUT=popup
• ...with --env-file .env and place LAYOUT=popup in the file

See installation page for more details.