VRChat keeps crashing or has issues launching properly

Installation Troubleshooting

If you can launch VRChat, follow these steps. However, these methods won't be helpful if VRChat doesn't start. Please refer to the manual method in the next section.

1. Open your Quick Menu, then click on the "expand" button in the top right corner

   

2. Click the Settings tab in the bottom of the Main Menu.

   

3. Scroll down to Debug on the left side, then click on it. Click on "Clear Local Profile Data" and "Clear Content Cache".
   
   

Restart VRChat and then continue to the Final Troubleshooting Steps!

Meta Quest Troubleshooting

If you're having trouble accessing the settings menu in VRChat, follow these steps to troubleshoot crashing issues with VRChat on your Meta Quest device.

• Turn off your Quest to close all VRChat processes and files.
• Perform a full reinstallation of VRChat.
• Make sure your Meta Quest software is up to date by following this guide.

PC Troubleshooting

Automatic Method

Only use this method if you cannot complete the "In-App Method" above.This method works only on Windows 10/11. If you're using VRChat on Linux/SteamOS via Proton, you'll need to manually clear the folders. See the "Manual Method" for directories and registry keys.

1. Press your Windows key to bring up the Start menu.
2. Type "cmd".
3. Right click "Command Prompt" and select "Run as Administrator".
4. A UAC prompt will appear. Accept it.
5. A window will appear labeled "Administrator: Command Prompt".
6. Select the following block of text. Make sure you select ALL of it! Triple-click it with the mouse to select it all. Copy it with ctrl + c:

   rmdir /S /Q "%AppData%\..\LocalLow\VRChat\vrchat\Cookies" 2>nul & rmdir /S /Q "%AppData%\..\LocalLow\VRChat\vrchat\HTTPCache" 2>nul & rmdir /S /Q "%AppData%\..\LocalLow\VRChat\vrchat\Unity" 2>nul & rmdir /S /Q "%AppData%\..\LocalLow\VRChat\vrchat\VRCHTTPCache" 2>nul & rmdir /S /Q "%AppData%\..\LocalLow\VRChat\vrchat\HTTPCache-WindowsPlayer" 2>nul & rmdir /S /Q "%AppData%\..\LocalLow\VRChat\vrchat\Cache-WindowsPlayer" 2>nul & rmdir /S /Q "%TEMP%\VRChat\VRChat" 2>nul & rmdir /S /Q "%UserProfile%\.cache\yt-dlp" 2>nul & REG DELETE HKCU\Software\VRChat\vrchat /va

7. Right click in the Command Prompt window. The text will paste in.
8. Press Enter. It may take a few seconds to run.
9. The prompt will then ask you if you want to delete all keys under the VRChat key. Press Y for Yes, and then press Enter.
10. Close the window. Skip to the Final Troubleshooting Steps section.

If you got any errors, please continue into the Manual Method section.
 

Manual Method

Proceed with this section only if the "Automatic Method" does not work.
It is intended for advanced users and involves removing files and registry keys from important parts of your computer, so please be cautious and follow the instructions precisely.

• Clear VRChat Cache:
  1. Navigate to the following folder:
     C:\Users\[Your Username]\AppData\LocalLow\VRChat
  2. Note: If you cannot see the "AppData" folder, you may need to enable visibility of hidden folders in Windows Folder Options.
  3. You can quickly access the folder by pasting this into your Windows Explorer address bar:
     %USERPROFILE%\AppData\LocalLow\VRChat\vrchat
  4. In this folder, delete all folders except for LocalPlayerModerations and LocalAvatarData.
     Do not delete any of the files.
• Delete YouTube-dl Cache:
  1. Go to the following folder:
     %USERPROFILE%\.cache
  2. In this directory, delete the youtube-dl folder.
• Clear VRChat Settings (PlayerPrefs):
  1. Open the regedit app (Windows Registry Editor).
  2. Navigate to the following path:
     HKEY_CURRENT_USER\Software\VRChat\vrchat
  3. Delete the VRChat registry key to reset settings.
     Be careful when using the registry editor, as making incorrect changes could harm your system.
• Clear VRChat Temporary Files:
  1. Paste this path into your Windows Explorer address bar:
     %TEMP%\VRChat
  2. Delete the VRChat folder by right-clicking it and selecting "Delete".

Final Troubleshooting Steps

As a final step, ensure you've covered these crucial troubleshooting tasks to resolve your VRChat issue. If the problem persists after these steps, skip to this article's "Contact Support" section.

Verify Game Files

1. Open Steam and right-click VRChat in your library.
2. Select Properties > Local Files.
3. Click "Verify Integrity of Game Files."

Update Windows, Drivers, and External Programs

1. Ensure your Windows is up to date (only Windows 10 and 11 Stable builds are supported; Windows 7 is not).
2. Update your GPU drivers to the latest version.
3. If experiencing low frame rates, uninstall virtual audio software (e.g., VoiceMeeter, MorphVox) as their drivers can cause performance issues.
4. Whitelist VRChat.exe in your antivirus and firewall settings.
5. If whitelisting doesn't work, temporarily disable real-time protection on both your antivirus and firewall to check if they're causing the issue.

VRChat is only supported the current main-line Stable builds of Windows 10 and 11.

If you're using a Steam Deck, VRChat is supported on SteamOS through Proton. Other Linux distributions may work but are not officially supported.

Computer Specs

1. Ensure your PC meets VRChat’s recommended specs. Most modern PCs with a dedicated GPU built within the last three years should perform well.
2. Be mindful that VRChat contains user-generated content, which can sometimes be unoptimized, causing crashes or performance issues.
3. Gaming laptops are typically less powerful than desktops, so performance may vary.

Connection Issues

1. As a last resort for connection issues, try using a VPN. Cloudflare's WARP is allowed, but some other VPNs may be blocked.

Using a VPN may or may not have certain legal limitations in your country. Please ensure you know your local regulations.

Contacting Support

If you're still having issues, please use this form to send our Support team a ticket. Please describe your issue in detail. Include what you were doing at the time, what you were trying to accomplish, and what happened instead. It's very important to provide as much information as possible, as our Support team may ask you for further details.

If you are using VRChat on PC, you should include your output logs and any crash dump files you may have. We recommend creating a folder on your desktop, gathering the necessary files, and compressing them before sending.