immich-app/immich
1
0
Fork 0
mirror of https://github.com/immich-app/immich.git synced 2026-07-16 05:34:30 +03:00
Code Issues 783 Packages Projects Releases 22 Wiki Activity

[PR #25434] Update ROCm installation instructions in documentation #18211

New Issue
Open
opened 2026-02-05 16:34:33 +03:00 by OVERLORD · 0 comments
OVERLORD commented 2026-02-05 16:34:33 +03:00
Owner
Copy Link

📋 Pull Request Information

Original PR: https://github.com/immich-app/immich/pull/25434
Author: @aigarius
Created: 1/22/2026
Status: 🔄 Open

Base: main ← Head: patch-1

📝 Commits (2)

  • b9dba06 Update ROCm installation instructions in documentation
  • 832829a Update docs/docs/features/ml-hardware-acceleration.md

📊 Changes

1 file changed (+1 additions, -0 deletions)

View changed files

📝 docs/docs/features/ml-hardware-acceleration.md (+1 -0)

📄 Description

Clarify server requirements for ROCm installation and usage.

Description

A user unfamiliar with machine learning and ROCm setup in general might not know that a specific kernel module needs to be installed on the server. Without this module enabling accelerated processing (step-by-step as in this manual) would just produce a non-descriptive error message about NULL buffers.

A user may also stumble into the module signing issues if they have Secure Boot active in the BIOS. This can stop their server from properly booting or from using the new module, so it is useful to point people in the right direction.

How Has This Been Tested?

Just did a clean Immich installation on a fresh Debian server and validated that this is all that is needed for ROCm setup to work.

Checklist:

  • I have performed a self-review of my own code
  • I have made corresponding changes to the documentation if applicable
  • I have no unrelated changes in the PR.

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/immich-app/immich/pull/25434 **Author:** [@aigarius](https://github.com/aigarius) **Created:** 1/22/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `patch-1` --- ### 📝 Commits (2) - [`b9dba06`](https://github.com/immich-app/immich/commit/b9dba06483d2f0311286c2cbeb04b9f9359eafd5) Update ROCm installation instructions in documentation - [`832829a`](https://github.com/immich-app/immich/commit/832829acd582b613a7880506b1655ac1f6afec53) Update docs/docs/features/ml-hardware-acceleration.md ### 📊 Changes **1 file changed** (+1 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/docs/features/ml-hardware-acceleration.md` (+1 -0) </details> ### 📄 Description Clarify server requirements for ROCm installation and usage. ## Description A user unfamiliar with machine learning and ROCm setup in general might not know that a specific kernel module needs to be installed on the server. Without this module enabling accelerated processing (step-by-step as in this manual) would just produce a non-descriptive error message about NULL buffers. A user may also stumble into the module signing issues if they have Secure Boot active in the BIOS. This can stop their server from properly booting or from using the new module, so it is useful to point people in the right direction. ## How Has This Been Tested? Just did a clean Immich installation on a fresh Debian server and validated that this is all that is needed for ROCm setup to work. ## Checklist: - [x] I have performed a self-review of my own code - [x] I have made corresponding changes to the documentation if applicable - [x] I have no unrelated changes in the PR. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
OVERLORD added the pull-request label 2026-02-05 16:34:33 +03:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
accessibility
changelog:enhancement
changelog:security
changelog:skip
changelog:translation
cli
date-time
dependencies
documentation
external-library
format
good first issue
mobile-beta
mobile-beta
mobile-beta
needs-answer
nice to have
pull-request
Mirrored from GitHub Pull Request
 sharing
tech-debt
📱mobile
🖥️web
🗄️server
🧠machine-learning
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
OVERLORD
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: immich-app/immich#18211
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?