Guides:Connection issues: Difference between revisions

From VRChat Wiki
Hackebein (talk | contribs)
updates with commen practice from discord
Hackebein (talk | contribs)
Marked this version for translation
 
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:62-->
This guide covers [[Special:MyLanguage/Troubleshooting|connection issues]] with [[Special:MyLanguage/VRChat|VRChat]]. Connecting to VRChat requires a reliable path to Cloudflare, AWS CloudFront, and Photon Engine.<ref name="vrc-conn">{{VRC link|https://help.vrchat.com/hc/en-us/articles/360062658433-Troubleshooting-Connection-Issues-with-VRChat|Troubleshooting Connection Issues with VRChat}} on ''help.vrchat.com''.</ref> Check VRChat's official status outlets before changing local network settings.
This guide covers [[Special:MyLanguage/Troubleshooting|connection issues]] with [[Special:MyLanguage/VRChat|VRChat]]. Connecting to VRChat requires a reliable path to Cloudflare, AWS CloudFront, and Photon Engine.<ref name="vrc-conn">{{VRC link|https://help.vrchat.com/hc/en-us/articles/360062658433-Troubleshooting-Connection-Issues-with-VRChat|Troubleshooting Connection Issues with VRChat}} on ''help.vrchat.com''.</ref> Check VRChat's official status outlets before changing local network settings.


<!--T:63-->
== Glossary ==
== Glossary ==
This guide uses the following terms:
This guide uses the following terms:


<!--T:64-->
* '''DNS''' — Domain Name System: a protocol that resolves a domain name to an IP address.
* '''DNS''' — Domain Name System: a protocol that resolves a domain name to an IP address.
* '''IP''' — Internet Protocol address: an address that identifies a device on a network.
* '''IP''' — Internet Protocol address: an address that identifies a device on a network.
Line 13: Line 16:
* '''VPN''' — Virtual Private Network: software that routes traffic through another network, often changing the apparent IP address.
* '''VPN''' — Virtual Private Network: software that routes traffic through another network, often changing the apparent IP address.


<!--T:65-->
== Check official outlets ==
== Check official outlets ==
VRChat publishes confirmed instabilities and outages through the following outlets.
VRChat publishes confirmed instabilities and outages through the following outlets.


<!--T:66-->
On the web:
On the web:


<!--T:67-->
* {{VRC link|https://status.vrchat.com|status.vrchat.com}}
* {{VRC link|https://status.vrchat.com|status.vrchat.com}}
* [https://x.com/VRChat_Status @VRChat_Status] on X
* [https://x.com/VRChat_Status @VRChat_Status] on X


<!--T:68-->
On Discord:
On Discord:


<!--T:69-->
* [https://discord.com/channels/189511567539306508/400375734423781379 VRChat support channel] on VRChat's [[Special:MyLanguage/Discord servers|Discord servers]]
* [https://discord.com/channels/189511567539306508/400375734423781379 VRChat support channel] on VRChat's [[Special:MyLanguage/Discord servers|Discord servers]]


<!--T:70-->
Help articles for connection, firewall, ports, uploads, and downloads are listed under [[#Official resources]].
Help articles for connection, firewall, ports, uploads, and downloads are listed under [[#Official resources]].


<!--T:71-->
=== Upstream providers ===
=== Upstream providers ===
VRChat depends on several upstream providers for account authorization, [[Special:MyLanguage/Instances|instance]] hosting, and purchases. Outages or maintenance on those services can affect sign-in, instances, and the [[Special:MyLanguage/Creator Economy|Creator Economy]]. For Photon regions, Thunes, and related providers, see [[Special:MyLanguage/Community:Server infrastructure|Server infrastructure]].
VRChat depends on several upstream providers for account authorization, [[Special:MyLanguage/Instances|instance]] hosting, and purchases. Outages or maintenance on those services can affect sign-in, instances, and the [[Special:MyLanguage/Creator Economy|Creator Economy]]. For Photon regions, Thunes, and related providers, see [[Special:MyLanguage/Community:Server infrastructure|Server infrastructure]].


<!--T:72-->
== Unstable connection ==
== Unstable connection ==
If the status outlets above do not show an incident, some users change DNS, prefer IPv4 over IPv6, or use Cloudflare WARP. This guide treats DNS as the first local change. Disabling IPv6 is not recommended on Windows, and it can remove Internet access on IPv6-only ISPs.<ref name="ms-ipv6">[https://learn.microsoft.com/en-us/troubleshoot/windows-server/networking/configure-ipv6-in-windows Configure IPv6 for advanced users] on ''learn.microsoft.com''.</ref>
If the status outlets above do not show an incident, some users change DNS, prefer IPv4 over IPv6, or use Cloudflare WARP. This guide treats DNS as the first local change. Disabling IPv6 is not recommended on Windows, and it can remove Internet access on IPv6-only ISPs.<ref name="ms-ipv6">[https://learn.microsoft.com/en-us/troubleshoot/windows-server/networking/configure-ipv6-in-windows Configure IPv6 for advanced users] on ''learn.microsoft.com''.</ref>


<!--T:73-->
=== Configure DNS ===
=== Configure DNS ===
Write down the current DNS addresses before changing them, so the previous settings can be restored.<ref name="google-dns">[https://developers.google.com/speed/public-dns/docs/using Get Started with Google Public DNS] on ''developers.google.com''.</ref> This section uses [https://one.one.one.one/ Cloudflare 1.1.1.1] as the example. Set '''1.1.1.1''' as the preferred IPv4 resolver and '''1.0.0.1''' as the alternate.<ref name="cf-ips">[https://developers.cloudflare.com/1.1.1.1/ip-addresses/ IP addresses] on ''developers.cloudflare.com''.</ref> If the connection has IPv6, set that same provider's IPv6 DNS addresses as well. Do not mix one provider's IPv4 addresses with another provider's IPv6 addresses.
Write down the current DNS addresses before changing them, so the previous settings can be restored.<ref name="google-dns">[https://developers.google.com/speed/public-dns/docs/using Get Started with Google Public DNS] on ''developers.google.com''.</ref> This section uses [https://one.one.one.one/ Cloudflare 1.1.1.1] as the example. Set '''1.1.1.1''' as the preferred IPv4 resolver and '''1.0.0.1''' as the alternate.<ref name="cf-ips">[https://developers.cloudflare.com/1.1.1.1/ip-addresses/ IP addresses] on ''developers.cloudflare.com''.</ref> If the connection has IPv6, set that same provider's IPv6 DNS addresses as well. Do not mix one provider's IPv4 addresses with another provider's IPv6 addresses.


<!--T:74-->
On IPv6-only networks, use the provider's IPv6 DNS addresses. Cloudflare and Google both publish IPv6 resolver addresses.<ref name="cf-ips" /><ref name="google-dns" />
On IPv6-only networks, use the provider's IPv6 DNS addresses. Cloudflare and Google both publish IPv6 resolver addresses.<ref name="cf-ips" /><ref name="google-dns" />


<!--T:75-->
Use first-party setup pages. VPN or security apps sometimes document their own resolver addresses; use those only if you mean to use that vendor's DNS. Otherwise use Cloudflare, Google, or another provider from the table below.
Use first-party setup pages. VPN or security apps sometimes document their own resolver addresses; use those only if you mean to use that vendor's DNS. Otherwise use Cloudflare, Google, or another provider from the table below.


<!--T:76-->
* Windows: [https://developers.cloudflare.com/1.1.1.1/setup/windows/ Set up 1.1.1.1 on Windows] on ''developers.cloudflare.com''; [https://support.microsoft.com/en-us/windows/essential-network-settings-and-tasks-in-windows-f21a9bbc-c582-55cd-35e0-73431160a1b9 Essential network settings and tasks in Windows] on ''support.microsoft.com''
* Windows: [https://developers.cloudflare.com/1.1.1.1/setup/windows/ Set up 1.1.1.1 on Windows] on ''developers.cloudflare.com''; [https://support.microsoft.com/en-us/windows/essential-network-settings-and-tasks-in-windows-f21a9bbc-c582-55cd-35e0-73431160a1b9 Essential network settings and tasks in Windows] on ''support.microsoft.com''
* macOS: [https://developers.cloudflare.com/1.1.1.1/setup/macos/ Set up 1.1.1.1 on macOS] on ''developers.cloudflare.com''; [https://support.apple.com/guide/mac-help/change-dns-settings-on-mac-mh14127/mac Change DNS settings on Mac] on ''support.apple.com''
* macOS: [https://developers.cloudflare.com/1.1.1.1/setup/macos/ Set up 1.1.1.1 on macOS] on ''developers.cloudflare.com''; [https://support.apple.com/guide/mac-help/change-dns-settings-on-mac-mh14127/mac Change DNS settings on Mac] on ''support.apple.com''
* Linux: [https://developers.cloudflare.com/1.1.1.1/setup/linux/ Set up 1.1.1.1 on Linux] on ''developers.cloudflare.com''; [https://developers.google.com/speed/public-dns/docs/using Get Started with Google Public DNS] on ''developers.google.com''
* Linux: [https://developers.cloudflare.com/1.1.1.1/setup/linux/ Set up 1.1.1.1 on Linux] on ''developers.cloudflare.com''; [https://developers.google.com/speed/public-dns/docs/using Get Started with Google Public DNS] on ''developers.google.com''


<!--T:77-->
Cloudflare 1.1.1.1 addresses:<ref name="cf-ips" />
Cloudflare 1.1.1.1 addresses:<ref name="cf-ips" />
<syntaxhighlight lang="text">
<syntaxhighlight lang="text">
Line 50: Line 66:
1.0.0.1
1.0.0.1


<!--T:78-->
IPv6
IPv6
2606:4700:4700::1111
2606:4700:4700::1111
Line 55: Line 72:
</syntaxhighlight>
</syntaxhighlight>


<!--T:79-->
Other public DNS providers can be used instead of Cloudflare:
Other public DNS providers can be used instead of Cloudflare:
</translate>
</translate>
Line 96: Line 114:
|}
|}
<translate>
<translate>
<!--T:80-->
=== Prefer IPv4 over IPv6 on Windows ===
=== Prefer IPv4 over IPv6 on Windows ===
Microsoft does not recommend disabling IPv6, unbinding IPv6 from interfaces, or disabling IPv6 components. Microsoft recommends preferring IPv4 over IPv6 in prefix policies instead, by setting the <code>DisabledComponents</code> registry value to decimal 32 (<code>0x20</code>).<ref name="ms-ipv6" /> This option may not work if the ISP no longer offers IPv4.
Microsoft does not recommend disabling IPv6, unbinding IPv6 from interfaces, or disabling IPv6 components. Microsoft recommends preferring IPv4 over IPv6 in prefix policies instead, by setting the <code>DisabledComponents</code> registry value to decimal 32 (<code>0x20</code>).<ref name="ms-ipv6" /> This option may not work if the ISP no longer offers IPv4.


<!--T:81-->
Microsoft warns that an incorrect registry change can cause serious problems. Back up the registry first, and restart the PC after the change.<ref name="ms-ipv6" />
Microsoft warns that an incorrect registry change can cause serious problems. Back up the registry first, and restart the PC after the change.<ref name="ms-ipv6" />


<!--T:82-->
To prefer IPv4 on Windows:
To prefer IPv4 on Windows:


<!--T:83-->
# Open Command Prompt as administrator: press the Windows key, type <code>cmd</code>, then choose '''Run as administrator'''.
# Open Command Prompt as administrator: press the Windows key, type <code>cmd</code>, then choose '''Run as administrator'''.
# Run:
# Run:
Line 111: Line 133:
# Optional check: run <code>netsh interface ipv6 show prefixpolicies</code>. The <code>::ffff:0:0/96</code> prefix should have a higher precedence than <code>::/0</code>.<ref name="ms-ipv6" />
# Optional check: run <code>netsh interface ipv6 show prefixpolicies</code>. The <code>::ffff:0:0/96</code> prefix should have a higher precedence than <code>::/0</code>.<ref name="ms-ipv6" />


<!--T:84-->
To undo the change:
To undo the change:


<!--T:85-->
# Open Command Prompt as administrator again.
# Open Command Prompt as administrator again.
# Run:
# Run:
Line 120: Line 144:
# Restart the PC.
# Restart the PC.


<!--T:86-->
=== Cloudflare WARP ===
=== Cloudflare WARP ===
[https://one.one.one.one/ Cloudflare WARP] is a further option after DNS changes. Setup is documented in Cloudflare's [https://developers.cloudflare.com/warp-client/get-started/ WARP client get-started] guide.
[https://one.one.one.one/ Cloudflare WARP] is a further option after DNS changes. Setup is documented in Cloudflare's [https://developers.cloudflare.com/warp-client/get-started/ WARP client get-started] guide.


<!--T:87-->
VRChat Help allows Cloudflare WARP as a last-resort VPN and states that some other VPNs may be blocked. Using a VPN may have legal limitations depending on local regulations.<ref name="vrc-crash">{{VRC link|https://help.vrchat.com/hc/en-us/articles/1500002247921-VRChat-keeps-crashing-or-has-issues-launching-properly|VRChat keeps crashing or has issues launching properly}} on ''help.vrchat.com''.</ref> VRChat Help also suggests trying Cloudflare WARP when content uploads hang because of ISP routing or throttling.<ref name="vrc-upload">{{VRC link|https://help.vrchat.com/hc/en-us/articles/1500002248501-I-m-stuck-on-building-or-uploading-content|I'm stuck on building or uploading content}} on ''help.vrchat.com''.</ref>
VRChat Help allows Cloudflare WARP as a last-resort VPN and states that some other VPNs may be blocked. Using a VPN may have legal limitations depending on local regulations.<ref name="vrc-crash">{{VRC link|https://help.vrchat.com/hc/en-us/articles/1500002247921-VRChat-keeps-crashing-or-has-issues-launching-properly|VRChat keeps crashing or has issues launching properly}} on ''help.vrchat.com''.</ref> VRChat Help also suggests trying Cloudflare WARP when content uploads hang because of ISP routing or throttling.<ref name="vrc-upload">{{VRC link|https://help.vrchat.com/hc/en-us/articles/1500002248501-I-m-stuck-on-building-or-uploading-content|I'm stuck on building or uploading content}} on ''help.vrchat.com''.</ref>


<!--T:88-->
Cloudflare documents two relevant modes:<ref name="cf-warp-modes">[https://developers.cloudflare.com/warp-client/warp-modes/ WARP modes] on ''developers.cloudflare.com''.</ref><ref name="cf-warp-vpn">[https://support.cloudflarewarp.com/hc/en-us/articles/360019372194-Is-the-1-1-1-1-app-a-VPN Is the 1.1.1.1 app a VPN?] on ''support.cloudflarewarp.com''.</ref>
Cloudflare documents two relevant modes:<ref name="cf-warp-modes">[https://developers.cloudflare.com/warp-client/warp-modes/ WARP modes] on ''developers.cloudflare.com''.</ref><ref name="cf-warp-vpn">[https://support.cloudflarewarp.com/hc/en-us/articles/360019372194-Is-the-1-1-1-1-app-a-VPN Is the 1.1.1.1 app a VPN?] on ''support.cloudflarewarp.com''.</ref>


<!--T:89-->
* '''WARP''' (tunnel) mode sends device traffic through Cloudflare. Cloudflare states that this replaces the original IP address with a Cloudflare IP that still represents an approximate location. WARP is not designed as an anonymizer or as a way to appear in a different country.<ref name="cf-warp-faq">[https://developers.cloudflare.com/warp-client/known-issues-and-faq/ Known issues and FAQ] on ''developers.cloudflare.com''.</ref><ref name="cf-warp-vpn" />
* '''WARP''' (tunnel) mode sends device traffic through Cloudflare. Cloudflare states that this replaces the original IP address with a Cloudflare IP that still represents an approximate location. WARP is not designed as an anonymizer or as a way to appear in a different country.<ref name="cf-warp-faq">[https://developers.cloudflare.com/warp-client/known-issues-and-faq/ Known issues and FAQ] on ''developers.cloudflare.com''.</ref><ref name="cf-warp-vpn" />
* '''DNS only''' mode sends DNS queries to Cloudflare and does not tunnel other traffic.<ref name="cf-warp-modes" />
* '''DNS only''' mode sends DNS queries to Cloudflare and does not tunnel other traffic.<ref name="cf-warp-modes" />


<!--T:90-->
VRChat Help notes that VPNs can slow downloads, and suggests disabling the VPN or excluding VRChat from the tunnel.<ref name="vrc-slow">{{VRC link|https://help.vrchat.com/hc/en-us/articles/14301364738707-I-m-experiencing-slow-download-speeds|I'm experiencing slow download speeds}} on ''help.vrchat.com''.</ref>
VRChat Help notes that VPNs can slow downloads, and suggests disabling the VPN or excluding VRChat from the tunnel.<ref name="vrc-slow">{{VRC link|https://help.vrchat.com/hc/en-us/articles/14301364738707-I-m-experiencing-slow-download-speeds|I'm experiencing slow download speeds}} on ''help.vrchat.com''.</ref>


<!--T:91-->
WARP tunnel mode can also break [[Special:MyLanguage/VRChat SDK|SDK]] uploads. [[Special:MyLanguage/Guides:Common SDK issues|Common SDK issues]] describes a "Missing Credentials" error while WARP is enabled, and recommends disabling WARP or switching to DNS-only 1.1.1.1 for that case.
WARP tunnel mode can also break [[Special:MyLanguage/VRChat SDK|SDK]] uploads. [[Special:MyLanguage/Guides:Common SDK issues|Common SDK issues]] describes a "Missing Credentials" error while WARP is enabled, and recommends disabling WARP or switching to DNS-only 1.1.1.1 for that case.


<!--T:92-->
=== Disabling IPv6 ===
=== Disabling IPv6 ===
Disabling IPv6 is a last option and is not recommended. Microsoft states that IPv6 is a mandatory part of current Windows versions, and that disabling or unbinding it can break Windows components.<ref name="ms-ipv6" /> On IPv6-only ISPs, disabling IPv6 can remove Internet access entirely.
Disabling IPv6 is a last option and is not recommended. Microsoft states that IPv6 is a mandatory part of current Windows versions, and that disabling or unbinding it can break Windows components.<ref name="ms-ipv6" /> On IPv6-only ISPs, disabling IPv6 can remove Internet access entirely.


<!--T:93-->
If IPv6 still needs to be limited on macOS, Apple documents a '''Link-local only''' TCP/IP option that limits IPv6 traffic to the local network.<ref name="apple-tcpip">[https://support.apple.com/guide/mac-help/change-tcpip-settings-on-mac-mh14129/mac Change TCP/IP settings on Mac] on ''support.apple.com''.</ref>
If IPv6 still needs to be limited on macOS, Apple documents a '''Link-local only''' TCP/IP option that limits IPv6 traffic to the local network.<ref name="apple-tcpip">[https://support.apple.com/guide/mac-help/change-tcpip-settings-on-mac-mh14129/mac Change TCP/IP settings on Mac] on ''support.apple.com''.</ref>


<!--T:94-->
== Troubleshooting ==
== Troubleshooting ==
Connection problems can also come from a slow or unstable path, a local firewall, or the VRChat client itself. VRChat Help for Meta Quest, Pico, and Vive XR Elite includes restarting the headset, trying another network, power-cycling the router to renew the IP address, and disabling IPv6 firewall features on the router (this is not the same as disabling IPv6).<ref name="vrc-conn" />
Connection problems can also come from a slow or unstable path, a local firewall, or the VRChat client itself. VRChat Help for Meta Quest, Pico, and Vive XR Elite includes restarting the headset, trying another network, power-cycling the router to renew the IP address, and disabling IPv6 firewall features on the router (this is not the same as disabling IPv6).<ref name="vrc-conn" />


<!--T:95-->
=== Update VRChat ===
=== Update VRChat ===
Update the VRChat client if the store (for example Steam or Meta) shows an available update.
Update the VRChat client if the store (for example Steam or Meta) shows an available update.


<!--T:96-->
=== Reboot router ===
=== Reboot router ===
Power the router off, wait a few minutes, and power it back on. VRChat Help notes that this often renews the IP address.<ref name="vrc-conn" />
Power the router off, wait a few minutes, and power it back on. VRChat Help notes that this often renews the IP address.<ref name="vrc-conn" />


<!--T:97-->
=== Installation and drivers ===
=== Installation and drivers ===
Update GPU drivers and check the VRChat installation. Reinstall VRChat if needed.
Update GPU drivers and check the VRChat installation. Reinstall VRChat if needed.


<!--T:98-->
=== Firewall, antivirus, and ports ===
=== Firewall, antivirus, and ports ===
Make sure the firewall or antivirus is not blocking VRChat. VRChat Help suggests adding a firewall exception for VRChat, or temporarily disabling the firewall during testing, then turning it back on.<ref name="vrc-conn" /> Some users also add Easy Anti-Cheat to the same exception list.
Make sure the firewall or antivirus is not blocking VRChat. VRChat Help suggests adding a firewall exception for VRChat, or temporarily disabling the firewall during testing, then turning it back on.<ref name="vrc-conn" /> Some users also add Easy Anti-Cheat to the same exception list.


<!--T:99-->
VRChat Help lists outbound ports that need to be allowed on a strict firewall, including UDP 5055 and 5056 for realtime networking.<ref name="vrc-ports">{{VRC link|https://help.vrchat.com/hc/en-us/articles/360062658793-Which-ports-do-I-need-to-open-for-VRChat|Which ports do I need to open for VRChat?}} on ''help.vrchat.com''.</ref>
VRChat Help lists outbound ports that need to be allowed on a strict firewall, including UDP 5055 and 5056 for realtime networking.<ref name="vrc-ports">{{VRC link|https://help.vrchat.com/hc/en-us/articles/360062658793-Which-ports-do-I-need-to-open-for-VRChat|Which ports do I need to open for VRChat?}} on ''help.vrchat.com''.</ref>


<!--T:100-->
=== Output logs ===
=== Output logs ===
On PC, VRChat output logs are under <code>%USERPROFILE%\AppData\LocalLow\VRChat\vrchat</code> and named <code>output_log_(date)</code>.<ref name="vrc-logs">{{VRC link|https://help.vrchat.com/hc/en-us/articles/9521522810899-Where-do-I-find-my-Output-Logs-and-Crash-Dumps|Where do I find my Output Logs and Crash Dumps?}} on ''help.vrchat.com''.</ref> For Quest, Linux, and crash dumps, see [[Special:MyLanguage/Guides:How to write efficient bug reports|How to write efficient bug reports]].
On PC, VRChat output logs are under <code>%USERPROFILE%\AppData\LocalLow\VRChat\vrchat</code> and named <code>output_log_(date)</code>.<ref name="vrc-logs">{{VRC link|https://help.vrchat.com/hc/en-us/articles/9521522810899-Where-do-I-find-my-Output-Logs-and-Crash-Dumps|Where do I find my Output Logs and Crash Dumps?}} on ''help.vrchat.com''.</ref> For Quest, Linux, and crash dumps, see [[Special:MyLanguage/Guides:How to write efficient bug reports|How to write efficient bug reports]].


<!--T:101-->
{{VRC link|https://vrch.at/support|VRChat User Support}} or the [[Special:MyLanguage/Discord servers|Discord]] support channel can help as a last resort.
{{VRC link|https://vrch.at/support|VRChat User Support}} or the [[Special:MyLanguage/Discord servers|Discord]] support channel can help as a last resort.


<!--T:102-->
=== System time ===
=== System time ===
Check that the system clock matches the current time in the configured time zone.
Check that the system clock matches the current time in the configured time zone.


<!--T:103-->
== Official resources ==
== Official resources ==
* {{VRC link|https://status.vrchat.com|status.vrchat.com}}
* {{VRC link|https://status.vrchat.com|status.vrchat.com}}
Line 173: Line 215:
* {{VRC link|https://help.vrchat.com/hc/en-us/articles/9521522810899-Where-do-I-find-my-Output-Logs-and-Crash-Dumps|Where do I find my Output Logs and Crash Dumps?}} on ''help.vrchat.com''
* {{VRC link|https://help.vrchat.com/hc/en-us/articles/9521522810899-Where-do-I-find-my-Output-Logs-and-Crash-Dumps|Where do I find my Output Logs and Crash Dumps?}} on ''help.vrchat.com''


<!--T:104-->
== Community resources ==
== Community resources ==
Downdetector can show user reports of ISP issues. It does not confirm an outage at a VRChat upstream provider.
Downdetector can show user reports of ISP issues. It does not confirm an outage at a VRChat upstream provider.
Line 192: Line 235:


<translate>
<translate>
== References ==
== References == <!--T:105-->
</translate>
</translate>
<references />
<references />


[[Category:Guides{{#translation:}}]]
[[Category:Guides{{#translation:}}]]

Latest revision as of 02:42, 14 August 2026

This guide covers connection issues with VRChat. Connecting to VRChat requires a reliable path to Cloudflare, AWS CloudFront, and Photon Engine.[1] Check VRChat's official status outlets before changing local network settings.

Glossary

This guide uses the following terms:

  • DNS — Domain Name System: a protocol that resolves a domain name to an IP address.
  • IP — Internet Protocol address: an address that identifies a device on a network.
  • ISP — Internet Service Provider: a company that provides Internet access. Examples include Comcast, Virgin, and NTT Docomo.
  • OS — Operating System.
  • Upstream provider — a third-party service that VRChat depends on for part of its infrastructure.
  • VPN — Virtual Private Network: software that routes traffic through another network, often changing the apparent IP address.

Check official outlets

VRChat publishes confirmed instabilities and outages through the following outlets.

On the web:

On Discord:

Help articles for connection, firewall, ports, uploads, and downloads are listed under #Official resources.

Upstream providers

VRChat depends on several upstream providers for account authorization, instance hosting, and purchases. Outages or maintenance on those services can affect sign-in, instances, and the Creator Economy. For Photon regions, Thunes, and related providers, see Server infrastructure.

Unstable connection

If the status outlets above do not show an incident, some users change DNS, prefer IPv4 over IPv6, or use Cloudflare WARP. This guide treats DNS as the first local change. Disabling IPv6 is not recommended on Windows, and it can remove Internet access on IPv6-only ISPs.[2]

Configure DNS

Write down the current DNS addresses before changing them, so the previous settings can be restored.[3] This section uses Cloudflare 1.1.1.1 as the example. Set 1.1.1.1 as the preferred IPv4 resolver and 1.0.0.1 as the alternate.[4] If the connection has IPv6, set that same provider's IPv6 DNS addresses as well. Do not mix one provider's IPv4 addresses with another provider's IPv6 addresses.

On IPv6-only networks, use the provider's IPv6 DNS addresses. Cloudflare and Google both publish IPv6 resolver addresses.[4][3]

Use first-party setup pages. VPN or security apps sometimes document their own resolver addresses; use those only if you mean to use that vendor's DNS. Otherwise use Cloudflare, Google, or another provider from the table below.

Cloudflare 1.1.1.1 addresses:[4]

IPv4
1.1.1.1
1.0.0.1

IPv6
2606:4700:4700::1111
2606:4700:4700::1001

Other public DNS providers can be used instead of Cloudflare:

Provider IPv4 Server IPv6 Server
Google 8.8.8.8

8.8.4.4

2001:4860:4860::8888

2001:4860:4860::8844

Control D 76.76.2.0

76.76.10.0

2606:1a40::

2606:1a40:1::

Quad9 9.9.9.9

149.112.112.112

2620:fe::fe

2620:fe::9

OpenDNS Home 208.67.222.222

208.67.220.220

Cloudflare 1.1.1.1

1.0.0.1

2606:4700:4700::1111

2606:4700:4700::1001

AdGuard DNS 94.140.14.14

94.140.15.15

2a10:50c0::ad1:ff

2a10:50c0::ad2:ff

CleanBrowsing Security 185.228.168.9

185.228.169.9

2a0d:2a00:1::2

2a0d:2a00:2::2

Prefer IPv4 over IPv6 on Windows

Microsoft does not recommend disabling IPv6, unbinding IPv6 from interfaces, or disabling IPv6 components. Microsoft recommends preferring IPv4 over IPv6 in prefix policies instead, by setting the DisabledComponents registry value to decimal 32 (0x20).[2] This option may not work if the ISP no longer offers IPv4.

Microsoft warns that an incorrect registry change can cause serious problems. Back up the registry first, and restart the PC after the change.[2]

To prefer IPv4 on Windows:

  1. Open Command Prompt as administrator: press the Windows key, type cmd, then choose Run as administrator.
  2. Run:
reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters" /v DisabledComponents /t REG_DWORD /d 32 /f
  1. Restart the PC.
  2. Optional check: run netsh interface ipv6 show prefixpolicies. The ::ffff:0:0/96 prefix should have a higher precedence than ::/0.[2]

To undo the change:

  1. Open Command Prompt as administrator again.
  2. Run:
reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters" /v DisabledComponents /t REG_DWORD /d 0 /f
  1. Restart the PC.

Cloudflare WARP

Cloudflare WARP is a further option after DNS changes. Setup is documented in Cloudflare's WARP client get-started guide.

VRChat Help allows Cloudflare WARP as a last-resort VPN and states that some other VPNs may be blocked. Using a VPN may have legal limitations depending on local regulations.[5] VRChat Help also suggests trying Cloudflare WARP when content uploads hang because of ISP routing or throttling.[6]

Cloudflare documents two relevant modes:[7][8]

  • WARP (tunnel) mode sends device traffic through Cloudflare. Cloudflare states that this replaces the original IP address with a Cloudflare IP that still represents an approximate location. WARP is not designed as an anonymizer or as a way to appear in a different country.[9][8]
  • DNS only mode sends DNS queries to Cloudflare and does not tunnel other traffic.[7]

VRChat Help notes that VPNs can slow downloads, and suggests disabling the VPN or excluding VRChat from the tunnel.[10]

WARP tunnel mode can also break SDK uploads. Common SDK issues describes a "Missing Credentials" error while WARP is enabled, and recommends disabling WARP or switching to DNS-only 1.1.1.1 for that case.

Disabling IPv6

Disabling IPv6 is a last option and is not recommended. Microsoft states that IPv6 is a mandatory part of current Windows versions, and that disabling or unbinding it can break Windows components.[2] On IPv6-only ISPs, disabling IPv6 can remove Internet access entirely.

If IPv6 still needs to be limited on macOS, Apple documents a Link-local only TCP/IP option that limits IPv6 traffic to the local network.[11]

Troubleshooting

Connection problems can also come from a slow or unstable path, a local firewall, or the VRChat client itself. VRChat Help for Meta Quest, Pico, and Vive XR Elite includes restarting the headset, trying another network, power-cycling the router to renew the IP address, and disabling IPv6 firewall features on the router (this is not the same as disabling IPv6).[1]

Update VRChat

Update the VRChat client if the store (for example Steam or Meta) shows an available update.

Reboot router

Power the router off, wait a few minutes, and power it back on. VRChat Help notes that this often renews the IP address.[1]

Installation and drivers

Update GPU drivers and check the VRChat installation. Reinstall VRChat if needed.

Firewall, antivirus, and ports

Make sure the firewall or antivirus is not blocking VRChat. VRChat Help suggests adding a firewall exception for VRChat, or temporarily disabling the firewall during testing, then turning it back on.[1] Some users also add Easy Anti-Cheat to the same exception list.

VRChat Help lists outbound ports that need to be allowed on a strict firewall, including UDP 5055 and 5056 for realtime networking.[12]

Output logs

On PC, VRChat output logs are under %USERPROFILE%\AppData\LocalLow\VRChat\vrchat and named output_log_(date).[13] For Quest, Linux, and crash dumps, see How to write efficient bug reports.

VRChat User Support or the Discord support channel can help as a last resort.

System time

Check that the system clock matches the current time in the configured time zone.

Official resources

Community resources

Downdetector can show user reports of ISP issues. It does not confirm an outage at a VRChat upstream provider.

Downdetector US https://downdetector.com/
Downdetector UK https://downdetector.co.uk/
Downdetector DE https://allestörungen.de/
Downdetector FR https://downdetector.fr/
Downdetector ES https://downdetector.es/
Downdetector JP https://downdetector.jp/

References

  1. 1.0 1.1 1.2 1.3 Troubleshooting Connection Issues with VRChat on help.vrchat.com.
  2. 2.0 2.1 2.2 2.3 2.4 Configure IPv6 for advanced users on learn.microsoft.com.
  3. 3.0 3.1 Get Started with Google Public DNS on developers.google.com.
  4. 4.0 4.1 4.2 IP addresses on developers.cloudflare.com.
  5. VRChat keeps crashing or has issues launching properly on help.vrchat.com.
  6. I'm stuck on building or uploading content on help.vrchat.com.
  7. 7.0 7.1 WARP modes on developers.cloudflare.com.
  8. 8.0 8.1 Is the 1.1.1.1 app a VPN? on support.cloudflarewarp.com.
  9. Known issues and FAQ on developers.cloudflare.com.
  10. I'm experiencing slow download speeds on help.vrchat.com.
  11. Change TCP/IP settings on Mac on support.apple.com.
  12. Which ports do I need to open for VRChat? on help.vrchat.com.
  13. Where do I find my Output Logs and Crash Dumps? on help.vrchat.com.