This location contains files from your host that need to be accessible to the application.

Target

/storage

Default

/mnt/user

Value

/mnt/user

This is the watch folder of the automatic video converter. Any video copied into this folder will be automatically converted by HandBrake.

Target

/watch

This is the default output folder for converted videos. Also used by the automatic video converter.

Target

/output

Preset used by the automatic video converter. Identification of the preset must follow the format 'CATEGORY/PRESET NAME'. Name of all available presets can be seen via the HandBrake GUI.

Target

AUTOMATED_CONVERSION_PRESET

Default

General/Very Fast 1080p30

Value

General/Very Fast 1080p30

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

Target

AUTOMATED_CONVERSION_FORMAT

Default

mp4

Value

mp4

Set to 0 to remove successfully converted videos from the watch folder, 1 to keep them.

Target

AUTOMATED_CONVERSION_KEEP_SOURCE

Default

1

Value

1

Set to

Target

AUTOMATED_CONVERSION_NON_VIDEO_FILE_ACTION

Default

ignore

Value

ignore

Root directory, inside the container, where converted videos should be written.

Target

AUTOMATED_CONVERSION_OUTPUT_DIR

Default

/output

Value

/output

Subdirectory of the output folder into which converted videos should be written. Leave value empty to save converted videos directly into

Target

AUTOMATED_CONVERSION_OUTPUT_SUBDIR

Default

all

Value

all

Default

all

Value

all

This is where the application stores its configuration, states, log and any files needing persistency.

Target

/config

Default

/mnt/user/appdata/HandBrake

Value

/mnt/user/appdata/HandBrake

When trash usage is enabled, this is where the automatic video converter moves converted files instead of deleting them.

Target

/trash

ID of the user the application runs as.

Target

USER_ID

Default

99

Value

99

ID of the group the application runs as.

Target

GROUP_ID

Default

100

Value

100

Mask that controls how file permissions are set for newly created files. The value of the mask is in octal notation.

Target

UMASK

Default

0000

Value

0000

Priority at which the application should run. A niceness value of -20 is the highest priority and 19 is the lowest priority. NOTE: Setting a negative value requires additional permissions. Thus,

Target

APP_NICENESS

Default

0

Value

0

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

Target

DISPLAY_WIDTH

Default

1920

Value

1920

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

Target

DISPLAY_HEIGHT

Default

1080

Value

1080

When set to

Target

DARK_MODE

Default

0

Value

0

When set to

Target

WEB_AUDIO

Default

0

Value

0

When set to

Target

WEB_AUTHENTICATION

Default

0

Value

0

Optional username to configure for the web authentication. This is a quick and easy way to configure credentials for a single user. To configure credentials in a more secure way, or to add more users, see the documentation.

Target

WEB_AUTHENTICATION_USERNAME

Optional password to configure for the web authentication. This is a quick and easy way to configure credentials for a single user. To configure credentials in a more secure way, or to add more users, see the documentation.

Target

WEB_AUTHENTICATION_PASSWORD

Whether or not an encrypted connection should be used to access the application's GUI. Set to

Target

SECURE_CONNECTION

Default

0

Value

0

Method used to perform the secure VNC connection. Possible values are

Target

SECURE_CONNECTION_VNC_METHOD

Default

SSL

Value

SSL

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

Target

SECURE_CONNECTION_CERTS_CHECK_INTERVAL

Default

60

Value

60

Port used by the web server to serve the UI of the application. This port is used internally by the container and it is usually not required to be changed. NOTE: This setting is relevant only when the Network Type is set to something else than Bridge.

Target

WEB_LISTENING_PORT

Default

5800

Value

5800

Port used by the VNC server to serve the UI of the application. This port is used internally by the container and it is usually not required to be changed. NOTE: This setting is relevant only when the Network Type is set to something else than Bridge.

Target

VNC_LISTENING_PORT

Default

5900

Value

5900

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

Target

HANDBRAKE_GUI

Default

1

Value

1

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

Target

AUTOMATED_CONVERSION

Default

1

Value

1

Space-separated list of file extensions to be considered as video files. By default, this list is empty, meaning that the automatic video converter will let HandBrake automatically detects if a file, no matter its extension, is a video or not (note that extensions defined by the Non-Video File Extensions list are always considered as non-video files). Normally, this variable doesn't need to be set. Usage of this variable is useful when only specific video files need to converted.

Target

AUTOMATED_CONVERSION_VIDEO_FILE_EXTENSIONS

Space-separated list of file extensions to be considered as not being videos. Most non-video files are properly rejected by HandBrake. However, some files, like images, are convertible by HandBrake even if they are not video files.

Target

AUTOMATED_CONVERSION_NON_VIDEO_FILE_EXTENSIONS

Default

jpg jpeg bmp png gif txt nfo

Value

jpg jpeg bmp png gif txt nfo

Setting this to 1 allows the final destination file to be overwritten if it already exists.

Target

AUTOMATED_CONVERSION_OVERWRITE_OUTPUT

Default

0

Value

0

Time (in seconds) during which properties (e.g. size, time, etc) of a video file in the watch folder need to remain the same. This is to avoid processing a file that is being copied.

Target

AUTOMATED_CONVERSION_SOURCE_STABLE_TIME

Default

5

Value

5

Minimum title duration (in seconds). Shorter titles will be ignored. This applies only to video disc sources (ISO file, VIDEO_TS folder or BDMV folder).

Target

AUTOMATED_CONVERSION_SOURCE_MIN_DURATION

Default

10

Value

10

Setting this to 1 enables HandBrake main feature title detection to try to guess and select the main title.

Target

AUTOMATED_CONVERSION_SOURCE_MAIN_TITLE_DETECTION

Default

0

Value

0

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

Target

AUTOMATED_CONVERSION_CHECK_INTERVAL

Default

5

Value

5

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

Target

AUTOMATED_CONVERSION_MAX_WATCH_FOLDERS

Default

5

Value

5

Set to 1 to disable display of the video conversion progress in HandBrake GUI.

Target

AUTOMATED_CONVERSION_NO_GUI_PROGRESS

Default

0

Value

0

Custom arguments to pass to HandBrake when performing a conversion.

Target

AUTOMATED_CONVERSION_HANDBRAKE_CUSTOM_ARGS

Space-separated list of Alpine Linux packages to install. This is useful when the automatic video converter's hooks require tools not available in the container image. See https://pkgs.alpinelinux.org for the list of available Alpine Linux packages.

Target

AUTOMATED_CONVERSION_INSTALL_PKGS

Set to 1 to enable usage of the trash directory. So when the automatic video converter is configured to not keep sources, it will move files to the trash directory (/trash inside the container) instead of deleting them.

Target

AUTOMATED_CONVERSION_USE_TRASH

Default

0

Value

0

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

Target

5800

Default

7803

Value

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

Target

5900

Default

7903

Value

7903