--- title: Shadowscale troubleshooting description: Test your connection in Shadowscale, fix a server list that won't update or a connection that doesn't work, what Shadowscale's messages mean, and how to send us your log. --- This page helps you find out what is wrong when Shadowscale doesn't work, and what to send us if you need help. Shadowscale is no longer updated, so if a problem keeps coming back, consider switching to [Floxcore](/en/docs/floxcore). AUTOMATIC_TABLE_OF_CONTENTS ## Test your connection While connected, go to **Info → Check connection** and tap **Check connection** at the bottom. Shadowscale tries one website through the VPX service, then the same website over your normal connection: | Result | What it means | | --- | --- | | **Connection OK** on both lines | Both worked at that moment. | | **VPN server unreachable** | The website couldn't be reached through the VPX service. Try another server or another network. | | **DNS not OK** | The VPX service worked, but your normal connection didn't. The problem is your network, not the VPX service. | Each test tries a different website, so run it two or three times. **Check VPN connection** on **Home** runs the same test in one line; there, a failure through the VPX service reads **Server unreachable**. ## Connected, but nothing loads 1. Run the connection test above. 2. Try another server. 3. Try another network, such as mobile data instead of Wi-Fi. 4. If only calls or games fail, check that **Allow UDP bypass** is on. If only some sites fail, try turning **Smart Routing** off and connecting again. See [Settings](/en/docs/shadowscale/settings). If everything works but slowly, see [Why is my connection slow?](/en/docs/slow-connection) ## Connect is gray - It reads **Configuration out-of-date**: your server list is more than 12 hours old. Update it as below. - Your server list is empty: add your servers with the QR code from the [setup guide](/en/setup/ios/shadowscale). If tapping **Connect** does nothing the first time, you may have tapped **Don't Allow** when your device asked to add a VPN configuration. Tap **Connect** again and choose **Allow**. ## The server list won't update Disconnect first, then pull down on the server list or tap **Settings → Update Subscribed Configuration**. While you are connected, a failed update always says your connection may be using out-of-date settings, whatever the real reason. | Message | What to do | | --- | --- | | **Subscription is no longer valid. Please rescan QR code to resubscribe.** | Your server list link no longer works: your service has ended or is suspended, or this device was deleted on our [Devices page](/en/devices). Check your service on our website; if it is active, scan a new QR code from the [setup guide](/en/setup/ios/shadowscale). | | A network message, such as **The request timed out.** | Your network couldn't reach our server. Try another network, or import a different QR code from the setup guide, such as **China 2** instead of **China 1**. | | **Server returned error code** with a number | Contact support with the number and the time. | | **Please update this app!** as a server name | Your Shadowscale is too old. Update it in the App Store. | Only **Import Success** confirms that an import worked: "Last updated: just now" can also appear after a failed import. ## Other messages | Message | What it means | | --- | --- | | **The configuration uses a password with invalid characters…** | The link can't be used. Get a new QR code from the setup guide. | | **Failed to parse proxy config** | The link wasn't copied completely, or it isn't a Shadowscale link. Scan the QR code instead. | | **No QRCode** | Shadowscale found no QR code in the picture you chose. Try a clearer picture, or scan the code directly. | | **Failed to switch VPN.** | Reconnecting to the server you tapped failed. Tap **Connect** again. | ## Send us your log Shadowscale has no chat with support, so [contact us](/en/contact) and attach the log: 1. Check that **Settings → Enable logging** is on. 2. Make the problem happen again. 3. Go to **Info → View Log**, tap the share icon at the top right, and share the log with us. The log contains your server addresses and login details. Send it only to us, never post it publicly. Also tell us what you were doing, the time, the exact message, which server you used, and your app version, shown at the top of **Home**.