Skip to content

Commit 66bc225

Browse files
RyanJDickpsychedelicious
authored andcommitted
Add a troubleshooting instructions for the Windows page file issue to the Low-VRAM docs.
1 parent 7535d2e commit 66bc225

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

docs/features/low-vram.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -145,3 +145,19 @@ It is strongly suggested to disable this feature:
145145
If the sysmem fallback feature sounds familiar, that's because Invoke's partial model loading strategy is conceptually very similar - use VRAM when there's room, else fall back to RAM.
146146

147147
Unfortunately, the Nvidia implementation is not optimized for applications like Invoke and does more harm than good.
148+
149+
## Troubleshooting
150+
151+
### Windows page file
152+
153+
Invoke has high virtual memory (a.k.a. 'committed memory') requirements. This can cause issues on Windows if the page file size limits are hit. (See this issue for the technical details on why this happens: https://github.com/invoke-ai/InvokeAI/issues/7563).
154+
155+
If you run out of page file space, InvokeAI may crash. Often, these crashes will happen with one of the following errors:
156+
157+
- InvokeAI exits with Windows error code `3221225477`
158+
- InvokeAI crashes without an error, but `eventvwr.msc` reveals an error with code `0xc0000005` (the hex equivalent of `3221225477`)
159+
160+
If you are running out of page file space, try the following solutions:
161+
162+
- Make sure that you have sufficient disk space for the page file to grow. Watch your disk usage as Invoke runs. If it climbs near 100% leading up to the crash, then this is very likely the source of the issue. Clear out some disk space to resolve the issue.
163+
- Make sure that your page file is set to "System managed size" (this is the default) rather than a custom size. Under the "System managed size" policy, the page file will grow dynamically as needed.

0 commit comments

Comments
 (0)