/
troubleshoot.md
178 lines (91 loc) · 8.68 KB
/
troubleshoot.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
Below are many common problems that people encountered:
### RuntimeError: CPUAllocator
See also the section: **System Swap**
### Model loaded, then paused, then nothing happens
See also the section: **System Swap**
### Segmentation Fault
See also the section: **System Swap**
### Aborted
See also the section: **System Swap**
### core dumped
See also the section: **System Swap**
### Killed
See also the section: **System Swap**
### ^C, then quit
See also the section: **System Swap**
### adm 2816, then stuck
See also the section: **System Swap**
### Connection errored out
See also the section: **System Swap**
### Error 1006
See also the section: **System Swap**
### WinError 10060
See also the section: **System Swap**
### Read timed out
See also the section: **System Swap**
### No error, but the console close in a flash. Cannot find any error.
See also the section: **System Swap**
### Model loading is extremely slow (more than 1 minute)
See also the section: **System Swap**
### System Swap
All above problems are caused by the fact that you do not have enough System Swap.
Please make sure that you have at least 40GB System Swap. In fact, it does not need so much Swap, but 40Gb should be safe for you to run Fooocus in 100% success.
(If you have more than 64GB RAM, then *perhaps* you do not need any System Swap, but we are not exactly sure about this.)
Also, if your system swap is on HDD, the speed of model loading will be very slow. Please try best to put system swap on SSD.
If you are using Linux/Mac, please follow your provider's instructions to set Swap Space. Herein, the "provider" refers to Ubuntu official, CentOS official, Mac official, etc.
If you are using Windows, you can set Swap here:
If you use both HDD and SSD, you *may* test some settings on the above step 7 to try best to put swap area on SSD, so that the speed of model loading will be faster.
**Important: Microsoft Windows 10/11 by default automate system swap for you so that you do not need to touch this dangerous setting. If you do not have enough system swap, just make sure that you have at least 40GB free space on each disk.** The Microsoft Windows 10/11 will automatically make swap areas for you.
Also, if you obtain Microsoft Windows 10/11 from some unofficial Chinese or Russian provider, they may have modified the default setting of system swap to advertise some "Enhanced Windows 10/11" (but actually they are just making things worse rather than improve things). In those cases, you may need to manually check if your system swap setting is consistent to the above screenshot.
Finally, note that you need to restart computer to activate any changes in system swap.
### MetadataIncompleteBuffer
See also the section: **Model corrupted**
### PytorchStreamReader failed
See also the section: **Model corrupted**
### Model corrupted
If you see Model Corrupted, then your model is corrupted. Fooocus will re-download corrupted models for you if your internet connection is good. Otherwise, you may also manually download models. You can find model url and their local location in the console each time a model download is requested.
### UserWarning: The operator 'aten::std_mean.correction' is not currently supported on the DML
This is a warning that you can ignore.
### Torch not compiled with CUDA enabled
You are not following the official installation guide.
Please do not trust those wrong tutorials on the internet, and please only trust the official installation guide.
### subprocess-exited-with-error
Please use python 3.10
Also, you are not following the official installation guide.
Please do not trust those wrong tutorials on the internet, and please only trust the official installation guide.
### SSL: CERTIFICATE_VERIFY_FAILED
Are you living in China? If yes, please consider turn off VPN, and/or try to download models manually.
If you get this error elsewhere in the world, then you may need to look at [this search](https://www.google.com/search?q=SSL+Certificate+Error). We cannot give very specific guide to fix this since the cause can vary a lot.
### CUDA kernel errors might be asynchronously reported at some other API call
A very small amount of devices does have this problem. The cause can be complicated but usually can be resolved after following these steps:
1. Make sure that you are using official version and latest version installed from [here](https://github.com/lllyasviel/Fooocus#download). (Some forks and other versions are more likely to cause this problem.)
2. Upgrade your Nvidia driver to the latest version. (Usually the version of your Nvidia driver should be 53X, not 3XX or 4XX.)
3. If things still do not work, then perhaps it is a problem with CUDA 12. You can use CUDA 11 and Xformers to try to solve this problem. We have prepared all files for you, and please do NOT install any CUDA or other environment on you own. The only one official way to do this is: (1) Backup and delete your `python_embeded` folder (near the `run.bat`); (2) Download the "previous_old_xformers_env.7z" from the [release page](https://github.com/lllyasviel/Fooocus/releases/tag/release), decompress it, and put the newly extracted `python_embeded` folder near your `run.bat`; (3) run Fooocus.
4. If it still does not work, please open an issue for us to take a look.
### Found no NVIDIA driver on your system
Please upgrade your Nvidia Driver.
If you are using AMD, please follow official installation guide.
### NVIDIA driver too old
Please upgrade your Nvidia Driver.
### I am using Mac, the speed is very slow.
Some MAC users may need `--disable-offload-from-vram` to speed up model loading.
Besides, the current support for MAC is very experimental, and we encourage users to also try Diffusionbee or Drawingthings: they are developed only for MAC.
### I am using Nvidia with 8GB VRAM, I get CUDA Out Of Memory
It is a BUG. Please let us know as soon as possible. Please make an issue. See also [minimal requirements](https://github.com/lllyasviel/Fooocus/tree/main?tab=readme-ov-file#minimal-requirement).
### I am using Nvidia with 6GB VRAM, I get CUDA Out Of Memory
It is very likely a BUG. Please let us know as soon as possible. Please make an issue. See also [minimal requirements](https://github.com/lllyasviel/Fooocus/tree/main?tab=readme-ov-file#minimal-requirement).
### I am using Nvidia with 4GB VRAM with Float16 support, like RTX 3050, I get CUDA Out Of Memory
It is a BUG. Please let us know as soon as possible. Please make an issue. See also [minimal requirements](https://github.com/lllyasviel/Fooocus/tree/main?tab=readme-ov-file#minimal-requirement).
### I am using Nvidia with 4GB VRAM without Float16 support, like GTX 960, I get CUDA Out Of Memory
Supporting GPU with 4GB VRAM without fp16 is extremely difficult, and you may not be able to use SDXL. However, you may still make an issue and let us know. You may try SD1.5 in Automatic1111 or other software for your device. See also [minimal requirements](https://github.com/lllyasviel/Fooocus/tree/main?tab=readme-ov-file#minimal-requirement).
### I am using AMD GPU on Windows, I get CUDA Out Of Memory
Current AMD support is very experimental for Windows. If you see this, then perhaps you cannot use Fooocus on this device on Windows.
However, if you re able to run SDXL on this same device on any other software, please let us know immediately, and we will support it as soon as possible. If no other software can enable your device to run SDXL on Windows, then we also do not have much to help.
Besides, the AMD support on Linux is slightly better because it will use ROCM. You may also try it if you are willing to change OS to linux. See also [minimal requirements](https://github.com/lllyasviel/Fooocus/tree/main?tab=readme-ov-file#minimal-requirement).
### I am using AMD GPU on Linux, I get CUDA Out Of Memory
Current AMD support for Linux is better than that for Windows, but still, very experimental. However, if you re able to run SDXL on this same device on any other software, please let us know immediately, and we will support it as soon as possible. If no other software can enable your device to run SDXL on Windows, then we also do not have much to help. See also [minimal requirements](https://github.com/lllyasviel/Fooocus/tree/main?tab=readme-ov-file#minimal-requirement).
### I tried flags like --lowvram or --gpu-only or --bf16 or so on, and things are not getting any better?
Please remove these flags if you are mislead by some wrong tutorials. In most cases these flags are making things worse and introducing more problems.
### Fooocus suddenly becomes very slow and I have not changed anything
Are you accidentally running two Fooocus at the same time?