| 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? | |