Shadowscale is our previous app for iPhone and iPad. It still works, but it is no longer updated, so it won't get new features or fixes. For a new setup, we recommend Floxcore or 12VPX NEO. This page explains how to use Shadowscale if you already do.
Contents
- Guides
- What Shadowscale does
- Add your servers
- Connect and disconnect
- Keep your server list up to date
- Rename or delete servers
- Shortcuts and Siri
- Language
- Moving to Floxcore
Guides
What Shadowscale does
Shadowscale connects the iPhone or iPad it runs on to the VPX service. It needs iOS or iPadOS 16 or newer. Everything you do in it affects only that device, so each device needs it set up once.
The app has no sign-in or account settings. Its "subscription" is the link that downloads your list of servers, not your paid service. Your account, renewals and devices are on our website.
The app has three tabs: Home, with your servers and the Connect button; Settings; and Info, with the log and a connection test.
Add your servers
- Install Shadowscale from the App Store and open it once.
- Open the Shadowscale setup guide and sign in. It shows a QR code.
- On your iPhone or iPad, tap the QR code: it opens Shadowscale and downloads your servers. If the QR code is on another screen, such as your computer's, tap + in Shadowscale and scan it instead.
- Wait for Import Success.
The setup page has several QR codes, such as China 1 and International. They all give the same servers, through different addresses: use International outside China and a China code in China. If one doesn't work, try the next. Each code expires if you don't use it within 30 minutes; reload the page for a new one.
Good to know:
- The first entry in your list, Switch to our Floxcore app., is a reminder, not a server.
- Server names start with the date of your server list.
- If Shadowscale opens but nothing is imported, leave it open, go back to the setup page and tap the QR code again.
- Importing a new QR code replaces your servers with the new list.
- If Shadowscale asks for camera access to scan, allow it. To scan a QR code saved as a picture, tap Album on the scanner screen.
Connect and disconnect
- On Home, tap a server so the checkmark is next to it.
- Tap Connect.
- The first time, allow Shadowscale to add a VPN configuration, and confirm with your passcode, Face ID or Touch ID if your device asks.
The button turns red and reads Disconnect when you are connected. To switch servers while connected, tap another server: Shadowscale reconnects to it straight away.
Once you connect, your device keeps Shadowscale connected by itself, also after a network change or a restart. To stop it, tap Disconnect in Shadowscale: switching off VPN in your device's Settings app may not keep it off.
Network: at the top of Home shows your Wi-Fi or mobile connection, not whether Shadowscale is connected.
Keep your server list up to date
Shadowscale downloads your server list again when you open it and the list is more than 3 hours old. To update it yourself, pull down on the server list, or tap Settings → Update Subscribed Configuration. If you are connected, Shadowscale reconnects for a moment to use the new list.
"Last updated" above the list shows when the list was last downloaded. If it is more than 12 hours old, the button reads Configuration out-of-date and you can't connect until you update. A connection that is already on keeps working.
If an update fails while you are connected, disconnect and update again: Shadowscale then shows the real reason. See Troubleshooting.
Rename or delete servers
Tap Edit on Home, swipe left on a server and choose Rename or Delete. Servers from your server list are grayed out: they can't be renamed or deleted, as each update replaces them.
Shortcuts and Siri
Shadowscale adds Start VPN and Stop VPN to the Shortcuts app. You can also say "Start Shadowscale VPN connection" or "Stop Shadowscale VPN connection" to Siri, in English. Start VPN connects to the server selected in the app. Both work only after you have connected once from the app.
Language
Settings → Language offers English, Simplified Chinese and Traditional Chinese. On a Japanese or Korean device, the app is in English.
Moving to Floxcore
Floxcore is our established app for iPhone, iPad, Apple TV and Mac. To switch, set it up with its own QR code from the Floxcore setup guide: it can't use Shadowscale's server list. Then delete Shadowscale, and remove its entry on our Devices page so it doesn't count towards your device limit.