Add AMD AMF & ROCm DockerMod (encode + compute)#17
Conversation
Installs AMD hardware video encode and optional GPU compute for FileFlows: - VA-API (Mesa radeonsi) - universal AMD encode path, works on every AMD GPU - AMF runtime (amf-amdgpu-pro) for the discrete GPUs AMF supports on Linux - Optional ROCm / OpenCL compute (off by default) via amdgpu-install --no-dkms Container-safe (no kernel module), amd64-only, idempotent and self-updating with apt garbage-collection, clean uninstall. Configurable via AMD_AMF_PROFILE (auto/standard/opencl/legacy).
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Adds a new DockerMod to enable AMD GPU hardware encoding (VA-API + AMF runtime) and optional compute (ROCm/OpenCL) inside the FileFlows container, with self-updating and clean uninstall behavior.
Changes:
- Introduces an install/uninstall Bash mod that detects distro/GPU, installs VA-API + AMF, and optionally installs ROCm/OpenCL via
amdgpu-install --no-dkms. - Adds a companion Markdown guide documenting profiles, requirements, verification, and troubleshooting.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| DockerMods/AMD AMF & ROCm.sh | New DockerMod installer/uninstaller implementing AMD encode + optional compute setup with idempotency and update checks. |
| DockerMods/AMD AMF & ROCm.md | New documentation describing what’s installed, how to configure profiles/env vars, and how to verify/troubleshoot. |
Comments suppressed due to low confidence (1)
DockerMods/AMD AMF & ROCm.sh:1
- The
#!/bin/bashshebang is not on the first line of the file. If the mod runner executes this file directly (rather than invokingbash <file>), the OS will not use Bash as the interpreter, which can break execution. Move the shebang to line 1 and keep the metadata/comment header immediately after it.
# ----------------------------------------------------------------------------------------------------
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
…ninstall - apply_opencl_workaround: set OCL_ICD_VENDORS to the default /etc/OpenCL/vendors (all ROCm ICDs are symlinked there) instead of the last-found ICD's directory. - Profile downgrade (compute -> encode-only): fall back to 'amdgpu-install -y --uninstall' when 'amdgpu-uninstall' is unavailable.
|
On the suppressed shebang note ( |
|
The markdown file might be the best location for this. Most users dont come to this repository directly and use the repository browser in the web console. So I need to think about this, one option maybe to use it how you have it, and update the repository generation to include this markdown if it exists as help for the DockerMod. Ill do some thinking |
CLA
[X] I agree that by opening a pull requests I am handing over copyright ownership of my work contained in that pull request to the FileFlows project and the project owner. My contribution will become licensed under the same license as the overall project.
AMD AMF & ROCm (Encode + Compute)
Adds a DockerMod that enables AMD GPU hardware video encode and optional GPU compute on the FileFlows (Ubuntu) image:
radeonsi) — the universal AMD encode path on Linux; works on every AMD GPU, including desktop iGPUs.amf-amdgpu-pro+libamdenc-amdgpu-pro) for the discrete GPUs AMF supports on Linux.AMD_AMF_PROFILE=standard/opencl) viaamdgpu-install --no-dkms.Built from AMD's official repositories and tooling. Container-safe (never installs a kernel module —
--no-dkms), amd64-only, idempotent and self-updating (discovers the newest AMF/driver builds for the image's Ubuntu release, withaptgarbage-collection), and a clean--uninstall. Configurable viaAMD_AMF_PROFILE(auto/standard/opencl/legacy), plusAMD_GFX_VERSION/AMD_HSA_OVERRIDE/ version pins.Tested on Ubuntu 26.04 inside the FileFlows image via the native DockerMod runner: install, idempotent re-run, and uninstall all clean;
hevc_vaapiverified on an AMD iGPU. Ships with a short companion guide (.md).