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

Objetivo

/config

Por defecto

/mnt/user/appdata/handbrake

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

Objetivo

/storage

Por defecto

/mnt/user

The location for videos to be automatically converted.

Objetivo

/watch

The destination for converted video files.

Objetivo

/output

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

Objetivo

/trash

ID of the user the application runs as.

Objetivo

USER_ID

Por defecto

99

ID of the group the application runs as.

Objetivo

GROUP_ID

Por defecto

100

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

Objetivo

UMASK

Por defecto

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

Objetivo

APP_NICENESS

Por defecto

0

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

Objetivo

DISPLAY_WIDTH

Por defecto

1920

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

Objetivo

DISPLAY_HEIGHT

Por defecto

1080

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

Objetivo

DARK_MODE

Por defecto

0

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

Objetivo

WEB_AUDIO

Por defecto

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.

Objetivo

WEB_FILE_MANAGER

Por defecto

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

Objetivo

WEB_FILE_MANAGER_ALLOWED_PATHS

Por defecto

AUTO

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

Objetivo

WEB_FILE_MANAGER_DENIED_PATHS

Por defecto

None

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

Objetivo

WEB_NOTIFICATION

Por defecto

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

Objetivo

WEB_TERMINAL

Por defecto

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.

Objetivo

WEB_AUTHENTICATION

Por defecto

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.

Objetivo

WEB_AUTHENTICATION_TOKEN_VALIDITY_TIME

Por defecto

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.

Objetivo

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.

Objetivo

WEB_AUTHENTICATION_PASSWORD

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

Objetivo

SECURE_CONNECTION

Por defecto

0

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

Objetivo

SECURE_CONNECTION_VNC_METHOD

Por defecto

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.

Objetivo

SECURE_CONNECTION_CERTS_CHECK_INTERVAL

Por defecto

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.

Objetivo

WEB_LISTENING_PORT

Por defecto

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.

Objetivo

VNC_LISTENING_PORT

Por defecto

5900

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

Objetivo

HANDBRAKE_GUI

Por defecto

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.

Objetivo

HANDBRAKE_GUI_QUEUE_STARTUP_ACTION

Por defecto

NONE

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

Objetivo

AUTOMATED_CONVERSION

Por defecto

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.

Objetivo

AUTOMATED_CONVERSION_PRESET

Por defecto

General/Very Fast 1080p30

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

Objetivo

AUTOMATED_CONVERSION_FORMAT

Por defecto

mp4

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

Objetivo

AUTOMATED_CONVERSION_KEEP_SOURCE

Por defecto

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.

Objetivo

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.

Objetivo

AUTOMATED_CONVERSION_NON_VIDEO_FILE_ACTION

Por defecto

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.

Objetivo

AUTOMATED_CONVERSION_NON_VIDEO_FILE_EXTENSIONS

Por defecto

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

Objetivo

AUTOMATED_CONVERSION_WATCH_DIR

Por defecto

AUTO

Root directory inside the container where converted videos are written.

Objetivo

AUTOMATED_CONVERSION_OUTPUT_DIR

Por defecto

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

Objetivo

AUTOMATED_CONVERSION_OUTPUT_SUBDIR

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

Objetivo

AUTOMATED_CONVERSION_OVERWRITE_OUTPUT

Por defecto

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.

Objetivo

AUTOMATED_CONVERSION_SOURCE_STABLE_TIME

Por defecto

5

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

Objetivo

AUTOMATED_CONVERSION_SOURCE_MIN_DURATION

Por defecto

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

Objetivo

AUTOMATED_CONVERSION_SOURCE_MAIN_TITLE_DETECTION

Por defecto

0

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

Objetivo

AUTOMATED_CONVERSION_CHECK_INTERVAL

Por defecto

5

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

Objetivo

AUTOMATED_CONVERSION_MAX_WATCH_FOLDERS

Por defecto

5

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

Objetivo

AUTOMATED_CONVERSION_NO_GUI_PROGRESS

Por defecto

0

Custom arguments to pass to HandBrake during conversion.

Objetivo

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.

Objetivo

AUTOMATED_CONVERSION_USE_TRASH

Por defecto

0

Location of the trash directory inside the container.

Objetivo

AUTOMATED_CONVERSION_TRASH_DIR

Por defecto

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

Objetivo

5800

Por defecto

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

Objetivo

5900

Por defecto

7903