12VPX
Shadowscale
Troubleshooting

Shadowscale troubleshooting

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.

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.

If everything works but slowly, see Why is my connection slow?

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.

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. Check your service on our website; if it is active, scan a new QR code from the setup guide.
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 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.

View as Markdown