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

Ziel

/config

Standard

/mnt/user/appdata/handbrake

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

Ziel

/storage

Standard

/mnt/user

The location for videos to be automatically converted.

Ziel

/watch

The destination for converted video files.

Ziel

/output

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

Ziel

/trash

ID of the user the application runs as.

Ziel

USER_ID

Standard

99

ID of the group the application runs as.

Ziel

GROUP_ID

Standard

100

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

Ziel

UMASK

Standard

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).

Ziel

APP_NICENESS

Standard

0

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

Ziel

DISPLAY_WIDTH

Standard

1920

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

Ziel

DISPLAY_HEIGHT

Standard

1080

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

Ziel

DARK_MODE

Standard

0

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

Ziel

WEB_AUDIO

Standard

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.

Ziel

WEB_FILE_MANAGER

Standard

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).

Ziel

WEB_FILE_MANAGER_ALLOWED_PATHS

Standard

AUTO

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

Ziel

WEB_FILE_MANAGER_DENIED_PATHS

Standard

None

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

Ziel

WEB_NOTIFICATION

Standard

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).

Ziel

WEB_TERMINAL

Standard

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.

Ziel

WEB_AUTHENTICATION

Standard

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.

Ziel

WEB_AUTHENTICATION_TOKEN_VALIDITY_TIME

Standard

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.

Ziel

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.

Ziel

WEB_AUTHENTICATION_PASSWORD

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

Ziel

SECURE_CONNECTION

Standard

0

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

Ziel

SECURE_CONNECTION_VNC_METHOD

Standard

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.

Ziel

SECURE_CONNECTION_CERTS_CHECK_INTERVAL

Standard

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.

Ziel

WEB_LISTENING_PORT

Standard

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.

Ziel

VNC_LISTENING_PORT

Standard

5900

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

Ziel

HANDBRAKE_GUI

Standard

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.

Ziel

HANDBRAKE_GUI_QUEUE_STARTUP_ACTION

Standard

NONE

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

Ziel

AUTOMATED_CONVERSION

Standard

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.

Ziel

AUTOMATED_CONVERSION_PRESET

Standard

General/Very Fast 1080p30

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

Ziel

AUTOMATED_CONVERSION_FORMAT

Standard

mp4

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

Ziel

AUTOMATED_CONVERSION_KEEP_SOURCE

Standard

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.

Ziel

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.

Ziel

AUTOMATED_CONVERSION_NON_VIDEO_FILE_ACTION

Standard

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.

Ziel

AUTOMATED_CONVERSION_NON_VIDEO_FILE_EXTENSIONS

Standard

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).

Ziel

AUTOMATED_CONVERSION_WATCH_DIR

Standard

AUTO

Root directory inside the container where converted videos are written.

Ziel

AUTOMATED_CONVERSION_OUTPUT_DIR

Standard

/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/`.

Ziel

AUTOMATED_CONVERSION_OUTPUT_SUBDIR

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

Ziel

AUTOMATED_CONVERSION_OVERWRITE_OUTPUT

Standard

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.

Ziel

AUTOMATED_CONVERSION_SOURCE_STABLE_TIME

Standard

5

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

Ziel

AUTOMATED_CONVERSION_SOURCE_MIN_DURATION

Standard

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).

Ziel

AUTOMATED_CONVERSION_SOURCE_MAIN_TITLE_DETECTION

Standard

0

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

Ziel

AUTOMATED_CONVERSION_CHECK_INTERVAL

Standard

5

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

Ziel

AUTOMATED_CONVERSION_MAX_WATCH_FOLDERS

Standard

5

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

Ziel

AUTOMATED_CONVERSION_NO_GUI_PROGRESS

Standard

0

Custom arguments to pass to HandBrake during conversion.

Ziel

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.

Ziel

AUTOMATED_CONVERSION_USE_TRASH

Standard

0

Location of the trash directory inside the container.

Ziel

AUTOMATED_CONVERSION_TRASH_DIR

Standard

/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`.

Ziel

5800

Standard

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`.

Ziel

5900

Standard

7903