Add documentation missing information for AMD devices.

[ArKam]

Add information required to be able to run invoke on AMD devices.

Summary

Improve invoke docker based installation documentation on AMD devices.

Related Issues / Discussions

None

QA Instructions

A simple straightforward documentation for people looking to run invoke on AMD based hardware.
Avoid users having to dig github issues and source code in order to find out docker requirements for AMD devices.

Merge Plan

None

Checklist

• The PR fit with invoke documentation requirements

[ebr]

Thank you for the contribution!

[ArKam]

Anyone that could merge this documentation update?

[ArKam]

@hipsterusername or @psychedelicious could you guys have a look at it? There are more and more issues created about ROCm support, and as I'm using it day to day I know the docker documentation is fine and working as I'm on AMD (fully) using up to ROCm 7.1 with invoke-ai with a GFX1030 (RX6600) and a GFX1201 (RX9070XT).

[hipsterusername]

@lstein and @blessedcoolant are the new maintainers you’ll want to have look at this.

🫡

[BieHDC]

as I'm using it day to day I know the docker documentation is fine and working as I'm on AMD (fully) using up to ROCm 7.1 with invoke-ai with a GFX1030 (RX6600) and a GFX1201 (RX9070XT).

Can you please share how you got it working?
I am trying to run it on my Strix Halo (gfx1151) system using this base container since it is a stable environment and has additional fixes. But Invoke has been fighting me and would just never detect rocm despite it being there and working fine for Comfy. I would really appreciate some pointers so i can contribute the guide back to kyuz0's repo.

[sam-g-steel]

as I'm using it day to day I know the docker documentation is fine and working as I'm on AMD (fully) using up to ROCm 7.1 with invoke-ai with a GFX1030 (RX6600) and a GFX1201 (RX9070XT).

Can you please share how you got it working? I am trying to run it on my Strix Halo (gfx1151) system using this base container since it is a stable environment and has additional fixes. But Invoke has been fighting me and would just never detect rocm despite it being there and working fine for Comfy. I would really appreciate some pointers so i can contribute the guide back to kyuz0's repo.

I just started working on the same thing! Id love to know of any progress.

[BieHDC]

I just started working on the same thing! Id love to know of any progress.

I tried it a few times with different strategies the last week and it always failed for different reasons. Did you get it working? Someone else seems to also work on updating rocm.

[sam-g-steel]

I just started working on the same thing! Id love to know of any progress.

I tried it a few times with different strategies the last week and it always failed for different reasons. Did you get it working? Someone else seems to also work on updating rocm.

Same! my biggest issue has been with the bits and bytes lib. Looks like better Strix Halo support is on its way but I could really use it now!

[sam-g-steel]

bitsandbytes just released an update that might help!

https://github.com/bitsandbytes-foundation/bitsandbytes/releases/tag/0.49.0
I'm going to give it a try later tonight!

[sam-g-steel]

Well... Close but no cigar!

I get the error below when trying to run SD1.x and SDXL models

Preparing first run of this install - may take a minute or two...
Started Invoke process with PID 28289
[2025-12-13 00:30:06,131]::[InvokeAI]::INFO --> Using torch device: AMD Radeon Graphics
[2025-12-13 00:30:06,134]::[InvokeAI]::INFO --> cuDNN version: 3003000
>> patchmatch.patch_match: INFO - Compiling and loading c extensions from "/home/sam/Programs/invokeai/.venv/lib/python3.12/site-packages/patchmatch".
>> patchmatch.patch_match: ERROR - patchmatch failed to load or compile (Command 'make clean && make' returned non-zero exit status 2.).
>> patchmatch.patch_match: INFO - Refer to https://invoke-ai.github.io/InvokeAI/installation/060_INSTALL_PATCHMATCH/ for installation instructions.
[2025-12-13 00:30:07,279]::[InvokeAI]::INFO --> Patchmatch not loaded (nonfatal)
[2025-12-13 00:30:07,632]::[InvokeAI]::INFO --> InvokeAI version 6.9.0
[2025-12-13 00:30:07,632]::[InvokeAI]::INFO --> Root directory = /home/sam/Programs/invokeai
[2025-12-13 00:30:07,632]::[InvokeAI]::INFO --> Initializing database at /home/sam/Programs/invokeai/databases/invokeai.db
[2025-12-13 00:30:07,635]::[ModelManagerService]::INFO --> [MODEL CACHE] Calculated model RAM cache size: 45090.93 MB. Heuristics applied: [1, 2].
[2025-12-13 00:30:07,699]::[InvokeAI]::INFO --> Invoke running on http://0.0.0.0:9090 (Press CTRL+C to quit)
[2025-12-13 00:31:54,741]::[InvokeAI]::INFO --> Executing queue item 234, session ceb556ac-c19f-4ff6-a719-8d15a05dc696
Fetching 11 files: 100%|█████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 11/11 [00:00<00:00, 25789.46it/s]
Loading pipeline components...: 100%|█████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 6/6 [00:00<00:00, 56.74it/s]
Memory access fault by GPU node-1 (Agent handle: 0x2645c230) on address 0x7fd665680000. Reason: Page not present or supervisor privilege.
Invoke process exited normally

(invoke) sam@fedora:~/Programs/invokeai$ pip list
Package                   Version
------------------------- --------------------------
annotated-types           0.7.0
anyio                     4.11.0
argcomplete               3.6.3
argon2-cffi               25.1.0
argon2-cffi-bindings      25.1.0
arrow                     1.4.0
asttokens                 3.0.0
async-lru                 2.0.5
attrs                     25.4.0
babel                     2.17.0
Beaker                    1.12.1
beautifulsoup4            4.14.3
bitsandbytes              0.49.0.dev0
bleach                    6.3.0
blivet                    3.12.1
blivet-gui                2.6.0
boto3                     1.42.6
botocore                  1.42.6
Brlapi                    0.8.7
Brotli                    1.2.0
certifi                   2025.7.9
cffi                      2.0.0
charset-normalizer        3.4.3
click                     8.1.7
cockpit                   351
comm                      0.2.3
crypt_r                   3.13.1
cryptography              45.0.4
cupshelpers               1.0
dasbus                    1.7
dbus_next                 0.2.3
dbus-python               1.4.0
debugpy                   1.8.17
decorator                 5.2.1
defusedxml                0.7.1
discid                    1.3.0
distro                    1.9.0
dnf                       4.24.0
dnspython                 2.8.0
email-validator           2.3.0
evdev                     1.9.1
executing                 2.2.1
fasteners                 0.20
fastjsonschema            2.21.2
fedora-third-party        0.10
file-magic                0.4.0
filelock                  3.20.0
fqdn                      1.5.1
fsspec                    2025.12.0
h11                       0.16.0
hid-parser                0.0.3
httpcore                  1.0.9
httpx                     0.28.1
humanize                  4.13.0
idna                      3.10
initial-setup             0.3.101
input-remapper            2.2.0
ipykernel                 7.1.0
ipython                   9.7.0
ipython_pygments_lexers   1.1.1
iso639                    0.1.4
isoduration               20.11.0
jedi                      0.19.2
Jinja2                    3.1.6
jmespath                  1.0.1
json5                     0.12.1
jsonpointer               3.0.0
jsonschema                4.23.0
jsonschema-specifications 2024.10.1
jupyter_client            8.6.3
jupyter_core              5.9.1
jupyter-events            0.12.0
jupyter-lsp               2.3.0
jupyter_server            2.17.0
jupyter_server_terminals  0.5.3
jupyterlab                4.4.10
jupyterlab_pygments       0.3.0
jupyterlab_server         2.28.0
langtable                 0.0.69
libcomps                  0.1.23
libdnf                    0.75.0
libdnf5                   5.2.17.0
louis                     3.33.0
lxml                      6.0.1
Mako                      1.2.3
Markdown                  3.10
MarkupSafe                3.0.3
matplotlib-inline         0.2.1
mistune                   3.1.4
mpmath                    1.3.0
mutagen                   1.47.0
nbclient                  0.10.2
nbconvert                 7.16.6
nbformat                  5.10.4
nest-asyncio              1.6.0
networkx                  3.6.1
nftables                  0.1
notebook_shim             0.2.4
numpy                     2.3.5
nvidia-cublas-cu12        12.8.4.1
nvidia-cuda-cupti-cu12    12.8.90
nvidia-cuda-nvrtc-cu12    12.8.93
nvidia-cuda-runtime-cu12  12.8.90
nvidia-cudnn-cu12         9.10.2.21
nvidia-cufft-cu12         11.3.3.83
nvidia-cufile-cu12        1.13.1.3
nvidia-curand-cu12        10.3.9.90
nvidia-cusolver-cu12      11.7.3.90
nvidia-cusparse-cu12      12.5.8.93
nvidia-cusparselt-cu12    0.7.1
nvidia-nccl-cu12          2.27.5
nvidia-nvjitlink-cu12     12.8.93
nvidia-nvshmem-cu12       3.3.20
nvidia-nvtx-cu12          12.8.90
olefile                   0.47
packaging                 25.0
pandocfilters             1.5.1
parso                     0.8.5
Paste                     3.10.1
perf                      0.1
pexpect                   4.9.0
picard                    2.13.3
pid                       3.0.4
pillow                    12.0.0
pip                       25.3
platformdirs              4.5.0
ply                       3.11
podman-compose            1.5.0
productmd                 1.49
prometheus_client         0.23.1
prompt_toolkit            3.0.52
psutil                    7.0.0
ptyprocess                0.7.0
pure_eval                 0.2.3
pwquality                 1.4.5
PyAudio                   0.2.13
pycairo                   1.28.0
pycparser                 2.22
pycrypto                  2.6.1
pycryptodomex             3.23.0
pycups                    2.0.4
pydantic                  2.12.5
pydantic_core             2.41.5
pydbus                    0.6.0
pyenchant                 3.2.2
Pygments                  2.19.2
PyGObject                 3.54.5
pyinotify                 0.9.6
PyJWT                     2.8.0
pykickstart               3.66
pyOpenSSL                 25.1.0
pyparsing                 3.1.2
pyparted                  3.13.0
PyQt5                     5.15.12.dev2507081429
PyQt5_sip                 12.17.1
PySocks                   1.7.1
python-augeas             1.2.0
python-dateutil           2.9.0.post0
python-dotenv             1.1.0
python-json-logger        4.0.0
python-libdiscid          2.0.2
python-linux-procfs       0.7.3
python-meh                0.52
python-pam                2.0.2
python-xlib               0.33
pytorch-triton-rocm       3.6.0+git5261b273
pyudev                    0.24.3
pyxdg                     0.27
PyYAML                    6.0.2
pyynl                     0.0.1
pyzmq                     27.1.0
RapidFuzz                 3.12.2
referencing               0.36.2
regex                     2025.10.23
requests                  2.32.5
requests-file             2.0.0
requests-ftp              0.3.1
rfc3339-validator         0.1.4
rfc3986-validator         0.1.1
rocm                      0.1.0
rpds-py                   0.27.0
rpm                       6.0.0
s3transfer                0.16.0
selinux                   3.9
Send2Trash                1.8.3
sepolicy                  3.9
setools                   4.6.0
setroubleshoot            3.3.33
setuptools                80.9.0
simpleaudio               1.0.4
simpleline                1.9.0
six                       1.17.0
sniffio                   1.3.1
solaar                    1.1.16
sos                       4.10.1
soupsieve                 2.8
stack-data                0.6.3
sympy                     1.14.0
systemd-python            235
terminado                 0.18.1
tinycss2                  1.4.0
torch                     2.10.0.dev20251208+rocm7.1
torchvision               0.25.0.dev20251209+rocm7.1
tornado                   6.5.2
traitlets                 5.14.3
triton                    3.5.1
typing_extensions         4.15.0
typing-inspection         0.4.2
tzdata                    2025.2
uri-template              1.3.0
urllib3                   2.6.1
vboxapi                   1
wcwidth                   0.2.14
webcolors                 25.10.0
webencodings              0.5.1
websocket-client          1.9.0
websockets                15.0.1
wheel                     0.45.1
xkbregistry               0.3
yt-dlp                    2025.10.22