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

Cible

/config

Défaut

/mnt/user/appdata/handbrake

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

Cible

/storage

Défaut

/mnt/user

The location for videos to be automatically converted.

Cible

/watch

The destination for converted video files.

Cible

/output

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

Cible

/trash

ID of the user the application runs as.

Cible

USER_ID

Défaut

99

ID of the group the application runs as.

Cible

GROUP_ID

Défaut

100

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

Cible

UMASK

Défaut

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

Cible

APP_NICENESS

Défaut

0

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

Cible

DISPLAY_WIDTH

Défaut

1920

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

Cible

DISPLAY_HEIGHT

Défaut

1080

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

Cible

DARK_MODE

Défaut

0

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

Cible

WEB_AUDIO

Défaut

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.

Cible

WEB_FILE_MANAGER

Défaut

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

Cible

WEB_FILE_MANAGER_ALLOWED_PATHS

Défaut

AUTO

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

Cible

WEB_FILE_MANAGER_DENIED_PATHS

Défaut

None

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

Cible

WEB_NOTIFICATION

Défaut

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

Cible

WEB_TERMINAL

Défaut

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.

Cible

WEB_AUTHENTICATION

Défaut

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.

Cible

WEB_AUTHENTICATION_TOKEN_VALIDITY_TIME

Défaut

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.

Cible

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.

Cible

WEB_AUTHENTICATION_PASSWORD

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

Cible

SECURE_CONNECTION

Défaut

0

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

Cible

SECURE_CONNECTION_VNC_METHOD

Défaut

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.

Cible

SECURE_CONNECTION_CERTS_CHECK_INTERVAL

Défaut

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.

Cible

WEB_LISTENING_PORT

Défaut

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.

Cible

VNC_LISTENING_PORT

Défaut

5900

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

Cible

HANDBRAKE_GUI

Défaut

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.

Cible

HANDBRAKE_GUI_QUEUE_STARTUP_ACTION

Défaut

NONE

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

Cible

AUTOMATED_CONVERSION

Défaut

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.

Cible

AUTOMATED_CONVERSION_PRESET

Défaut

General/Very Fast 1080p30

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

Cible

AUTOMATED_CONVERSION_FORMAT

Défaut

mp4

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

Cible

AUTOMATED_CONVERSION_KEEP_SOURCE

Défaut

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.

Cible

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.

Cible

AUTOMATED_CONVERSION_NON_VIDEO_FILE_ACTION

Défaut

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.

Cible

AUTOMATED_CONVERSION_NON_VIDEO_FILE_EXTENSIONS

Défaut

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

Cible

AUTOMATED_CONVERSION_WATCH_DIR

Défaut

AUTO

Root directory inside the container where converted videos are written.

Cible

AUTOMATED_CONVERSION_OUTPUT_DIR

Défaut

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

Cible

AUTOMATED_CONVERSION_OUTPUT_SUBDIR

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

Cible

AUTOMATED_CONVERSION_OVERWRITE_OUTPUT

Défaut

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.

Cible

AUTOMATED_CONVERSION_SOURCE_STABLE_TIME

Défaut

5

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

Cible

AUTOMATED_CONVERSION_SOURCE_MIN_DURATION

Défaut

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

Cible

AUTOMATED_CONVERSION_SOURCE_MAIN_TITLE_DETECTION

Défaut

0

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

Cible

AUTOMATED_CONVERSION_CHECK_INTERVAL

Défaut

5

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

Cible

AUTOMATED_CONVERSION_MAX_WATCH_FOLDERS

Défaut

5

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

Cible

AUTOMATED_CONVERSION_NO_GUI_PROGRESS

Défaut

0

Custom arguments to pass to HandBrake during conversion.

Cible

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.

Cible

AUTOMATED_CONVERSION_USE_TRASH

Défaut

0

Location of the trash directory inside the container.

Cible

AUTOMATED_CONVERSION_TRASH_DIR

Défaut

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

Cible

5800

Défaut

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

Cible

5900

Défaut

7903