Stores the application's configuration, state, logs, and any files requiring persistency.

目标

/config

默认值

/mnt/user/appdata/handbrake

Contains files from the host that need to be accessible to the application.

目标

/storage

默认值

/mnt/user

The location for videos to be automatically converted.

目标

/watch

The destination for converted video files.

目标

/output

When trash usage is enabled, converted source files are moved here instead of being deleted.

目标

/trash

ID of the user the application runs as.

目标

USER_ID

默认值

99

ID of the group the application runs as.

目标

GROUP_ID

默认值

100

Mask controlling permissions for newly created files and folders, specified in octal notation.

目标

UMASK

默认值

0000

Priority at which the application should run. A niceness value of `-20` is the highest, `19` is the lowest and `0` the default. NOTE: Setting a negative value requires additional permissions. Thus, `--cap-add=SYS_NICE` must be added to Extra Parameters (shown when Advanced View is enabled).

目标

APP_NICENESS

默认值

0

Width (in pixels) of the application's window.

目标

DISPLAY_WIDTH

默认值

1920

Height (in pixels) of the application's window.

目标

DISPLAY_HEIGHT

默认值

1080

When set to `1`, enables dark mode for the application.

目标

DARK_MODE

默认值

0

When set to `1`, enables audio support, allowing audio produced by the application to play through the browser.

目标

WEB_AUDIO

默认值

0

When set to `1`, enables the web file manager, allowing interaction with files inside the container through a web browser, supporting operations like renaming, deleting, uploading, and downloading.

目标

WEB_FILE_MANAGER

默认值

0

Comma-separated list of paths within the container that the file manager can access. By default, the container's entire filesystem is not accessible, and this variable specifies allowed paths. If set to `AUTO`, commonly used folders and those mapped to the container are automatically allowed. The value `ALL` allows access to all paths (no restrictions).

目标

WEB_FILE_MANAGER_ALLOWED_PATHS

默认值

AUTO

Comma-separated list of paths within the container that the file manager cannot access. A denied path takes precedence over an allowed path.

目标

WEB_FILE_MANAGER_DENIED_PATHS

默认值

None

When set to `1`, enables the web notification service, allowing the browser to display desktop notifications from the application.

目标

WEB_NOTIFICATION

默认值

0

When set to `1`, enables access to a terminal from the web interface. It is strongly recommended to configure the container with secure web access (HTTPS).

目标

WEB_TERMINAL

默认值

0

When set to `1`, protects the application's GUI with a login page when accessed via a web browser. Access is granted only with valid credentials.

目标

WEB_AUTHENTICATION

默认值

0

Lifetime of a token, in hours. A token is assigned to the user after successful login. As long as the token is valid, the user can access the application's GUI without logging in again. Once the token expires, the login page is displayed again.

目标

WEB_AUTHENTICATION_TOKEN_VALIDITY_TIME

默认值

24

Optional username for web authentication. Provides a quick and easy way to configure credentials for a single user. For more secure configuration or multiple users, see the documentation.

目标

WEB_AUTHENTICATION_USERNAME

Optional password for web authentication. Provides a quick and easy way to configure credentials for a single user. For more secure configuration or multiple users, see the documentation.

目标

WEB_AUTHENTICATION_PASSWORD

When set to `1`, uses an encrypted connection to access the application's GUI (via web browser or VNC client).

目标

SECURE_CONNECTION

默认值

0

Method used for encrypted VNC connection. Possible values are `SSL` or `TLS`.

目标

SECURE_CONNECTION_VNC_METHOD

默认值

SSL

Interval, in seconds, at which the system checks if web or VNC certificates have changed. When a change is detected, affected services are automatically restarted. A value of `0` disables the check.

目标

SECURE_CONNECTION_CERTS_CHECK_INTERVAL

默认值

60

Port used by the web server to serve the application's GUI. This port is internal to the container and typically does not need to be changed. NOTE: This setting is relevant only when the Network Type is set to something else than Bridge.

目标

WEB_LISTENING_PORT

默认值

5800

Port used by the VNC server to serve the application's GUI. This port is internal to the container and typically does not need to be changed. NOTE: This setting is relevant only when the Network Type is set to something else than Bridge.

目标

VNC_LISTENING_PORT

默认值

5900

Setting this to `1` enables the HandBrake GUI; `0` disables it.

目标

HANDBRAKE_GUI

默认值

1

Action to be taken on the HandBrake GUI queue at startup. When set to `PROCESS`, HandBrake automatically starts encoding items in the queue. When set to `CLEAR`, the queue is cleared. Any other value results in no action on the queue.

目标

HANDBRAKE_GUI_QUEUE_STARTUP_ACTION

默认值

NONE

Setting this to `1` enables the automatic video converter, `0` disables it.

目标

AUTOMATED_CONVERSION

默认值

1

Preset used by the automatic video converter. The preset must be identified in the format `CATEGORY/PRESET NAME`. Available presets can be seen via the HandBrake GUI.

目标

AUTOMATED_CONVERSION_PRESET

默认值

General/Very Fast 1080p30

Video container format used by the automatic video converter for output files, typically the video filename extension.

目标

AUTOMATED_CONVERSION_FORMAT

默认值

mp4

When set to `0`, a successfully converted video is removed from the watch folder.

目标

AUTOMATED_CONVERSION_KEEP_SOURCE

默认值

1

Space-separated list of file extensions considered as video files. By default, this list is empty, allowing HandBrake to automatically detect if a file is a video, regardless of its extension (except for extensions defined by `AUTOMATED_CONVERSION_NON_VIDEO_FILE_EXTENSIONS`, which are always considered non-video). This variable is typically unnecessary but useful when only specific video files need conversion.

目标

AUTOMATED_CONVERSION_VIDEO_FILE_EXTENSIONS

When set to `ignore`, non-video files in the watch folder are ignored. If set to `copy`, non-video files are copied as-is to the output folder.

目标

AUTOMATED_CONVERSION_NON_VIDEO_FILE_ACTION

默认值

ignore

Space-separated list of file extensions considered non-video. Most non-video files are properly rejected by HandBrake, but some files, like images, may be convertible despite not being videos.

目标

AUTOMATED_CONVERSION_NON_VIDEO_FILE_EXTENSIONS

默认值

jpg jpeg bmp png gif txt nfo

Path to the watch directory within the container. When set to `AUTO` (the default), the path is set to `/watch` for the first watch directory and `/watchX` for additional ones, where `X` is the index (e.g., `2` for the second).

目标

AUTOMATED_CONVERSION_WATCH_DIR

默认值

AUTO

Root directory inside the container where converted videos are written.

目标

AUTOMATED_CONVERSION_OUTPUT_DIR

默认值

/output

Subdirectory of the output folder where converted videos are written. By default, videos are saved directly to `/output/`. If set to `Home/Movies`, videos are written to `/output/Home/Movies`. Use `SAME_AS_SRC` to match the source subfolder. For example, if the source is `/watch/Movies/MyMovie/MyMovie.mkv`, the output is written to `/output/Movies/MyMovie/`.

目标

AUTOMATED_CONVERSION_OUTPUT_SUBDIR

When set to `1`, allows overwriting an existing destination file.

目标

AUTOMATED_CONVERSION_OVERWRITE_OUTPUT

默认值

0

Time (in seconds) during which properties (e.g., size, time) of a video file in the watch folder must remain unchanged to avoid processing a file being copied.

目标

AUTOMATED_CONVERSION_SOURCE_STABLE_TIME

默认值

5

Minimum title duration (in seconds). Shorter titles are ignored. Applies only to video disc sources (ISO files, `VIDEO_TS` folders, or `BDMV` folders).

目标

AUTOMATED_CONVERSION_SOURCE_MIN_DURATION

默认值

10

When set to `1`, enables HandBrake's main feature title detection to guess and select the main title. Applies only to video disc sources (ISO files, `VIDEO_TS` folders, or `BDMV` folders).

目标

AUTOMATED_CONVERSION_SOURCE_MAIN_TITLE_DETECTION

默认值

0

Interval (in seconds) at which the automatic video converter checks for new files.

目标

AUTOMATED_CONVERSION_CHECK_INTERVAL

默认值

5

Maximum number of watch folders handled by the automatic video converter.

目标

AUTOMATED_CONVERSION_MAX_WATCH_FOLDERS

默认值

5

When set to `1`, progress of videos converted by the automatic video converter is not shown in the HandBrake GUI.

目标

AUTOMATED_CONVERSION_NO_GUI_PROGRESS

默认值

0

Custom arguments to pass to HandBrake during conversion.

目标

AUTOMATED_CONVERSION_HANDBRAKE_CUSTOM_ARGS

When set to `1`, the automatic video converter uses the trash directory. This applies only when the converter is configured not to keep source files. In that case, they will be moved to the trash directory (`/trash` inside the container by default) instead of being permanently deleted.

目标

AUTOMATED_CONVERSION_USE_TRASH

默认值

0

Location of the trash directory inside the container.

目标

AUTOMATED_CONVERSION_TRASH_DIR

默认值

/trash

Port to access the application's GUI via the web interface. NOTE: This setting is relevant only when the Network Type is set to `Bridge`.

目标

5800

默认值

7803

Port to access the application's GUI via VNC protocol. Optional if no VNC client is used. NOTE: This setting is relevant only when the Network Type is set to `Bridge`.

目标

5900

默认值

7903