handbrake v0.1.0

Media

HandBrake — a powerful video transcoder with a browser-streamed GUI and an automatic watch-folder converter. Deployed as a single host-networked Nomad service.

nomad-pack run handbrake --registry nomploy

…or one line (add registry + run)

curl -fsSL https://packs.nomploy.com/install.sh | sh -s -- handbrake

Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.

Source ↗ Project ↗ ★ 1.2k ⚑ Report an issue

1 task http 5800 4 volumes image jlesage/handbrake:latest tracks :latest image bumped today

Variables 15

values.hcl

Save as values.hcl, edit, then run:

nomad-pack run handbrake -f values.hcl --registry nomploy

# The name of the Nomad job.
job_name = "handbrake"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The HandBrake container image. Pin a tag in production.
image = "jlesage/handbrake:latest"

# Host port for the browser-streamed GUI (WEB_LISTENING_PORT).
port = 5800

# Named volume mounted at /config (application settings).
data_volume = "handbrake_data"

# Named volume mounted at /storage — source media to pick from in the GUI.
storage_volume = "handbrake_storage"

# Named volume mounted at /watch — drop files here for automatic conversion.
watch_volume = "handbrake_watch"

# Named volume mounted at /output — converted files.
output_volume = "handbrake_output"

# User ID that owns the files (USER_ID).
user_id = 1000

# Group ID that owns the files (GROUP_ID).
group_id = 1000

# Container timezone (TZ), e.g. Europe/Bratislava.
tz = "UTC"

# Enable the watch-folder automatic converter (AUTOMATED_CONVERSION): 1 on, 0 off.
automated_conversion = 1

# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# The task resources.
resources = {
    cpu    = 4000
    memory = 2048
  }

Name	Type	Default	Description
job_name	string	"handbrake"	The name of the Nomad job.
namespace	string	"default"	The Nomad namespace to deploy into.
datacenters	list	["*"]	The datacenters to deploy to.
image	string	"jlesage/handbrake:latest"	The HandBrake container image. Pin a tag in production.
port	number	5800	Host port for the browser-streamed GUI (WEB_LISTENING_PORT).
data_volume	string	"handbrake_data"	Named volume mounted at /config (application settings).
storage_volume	string	"handbrake_storage"	Named volume mounted at /storage — source media to pick from in the GUI.
watch_volume	string	"handbrake_watch"	Named volume mounted at /watch — drop files here for automatic conversion.
output_volume	string	"handbrake_output"	Named volume mounted at /output — converted files.
user_id	number	1000	User ID that owns the files (USER_ID).
group_id	number	1000	Group ID that owns the files (GROUP_ID).
tz	string	"UTC"	Container timezone (TZ), e.g. Europe/Bratislava.
automated_conversion	number	1	Enable the watch-folder automatic converter (AUTOMATED_CONVERSION): 1 on, 0 off.
constraints	list	[]	Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources	object	{ cpu = 4000 memory = 2048 }	The task resources.

Back up this pack

This pack stores data in 4 Docker named volumes: handbrake_datahandbrake_storagehandbrake_watchhandbrake_output

restic

# Run on the node hosting this pack. Point restic at your repo first:
#   export RESTIC_REPOSITORY="s3:https://<account>.r2.cloudflarestorage.com/<bucket>"
#   export RESTIC_PASSWORD="<repo-password>"
#   export AWS_ACCESS_KEY_ID=<key>  AWS_SECRET_ACCESS_KEY=<secret>
restic backup \
  /var/lib/docker/volumes/handbrake_data/_data \
  /var/lib/docker/volumes/handbrake_storage/_data \
  /var/lib/docker/volumes/handbrake_watch/_data \
  /var/lib/docker/volumes/handbrake_output/_data

rclone (sync to S3/R2)

rclone sync /var/lib/docker/volumes/handbrake_data/_data backup:<bucket>/handbrake_data
rclone sync /var/lib/docker/volumes/handbrake_storage/_data backup:<bucket>/handbrake_storage
rclone sync /var/lib/docker/volumes/handbrake_watch/_data backup:<bucket>/handbrake_watch
rclone sync /var/lib/docker/volumes/handbrake_output/_data backup:<bucket>/handbrake_output

Paths assume the default Docker volume location (/var/lib/docker/volumes). Restore by stopping the job, restoring files into the same volume, and re-running the pack.

Readme

handbrake

HandBrake — the popular open-source video transcoder, here with a browser-streamed GUI (no VNC client needed) plus an automatic watch-folder converter. Rip and re-encode video to modern codecs with presets, manually via the GUI or automatically by dropping files into a watch folder.

Single host-networked Nomad service with config, source, watch and output volumes.

Deploy

nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run handbrake --registry=nomploy

Configure

Variable	Default	Description
`port`	`5800`	Browser GUI port (`WEB_LISTENING_PORT`).
`automated_conversion`	`1`	Auto-convert files dropped in `/watch` (`AUTOMATED_CONVERSION`): `1` on, `0` off.
`image`	`jlesage/handbrake:latest`	Container image. Pin a tag in production.
`data_volume`	`handbrake_data`	`/config` — settings.
`storage_volume`	`handbrake_storage`	`/storage` — source media to pick in the GUI.
`watch_volume`	`handbrake_watch`	`/watch` — drop files here for auto-conversion.
`output_volume`	`handbrake_output`	`/output` — converted files.
`user_id` / `group_id`	`1000` / `1000`	File ownership (`USER_ID`/`GROUP_ID`).
`tz`	`UTC`	Container timezone (`TZ`).
`resources`	`{ cpu = 4000, memory = 2048 }`	Task resources. Transcoding is CPU-heavy — give it cores.

The GUI has no auth by default — put it behind an authenticating reverse proxy over TLS if exposed. For hardware acceleration, pass the render device through and use a QSV/NVENC/VAAPI preset. Pin the job to the node holding the volumes with constraints.