--- title: Shadowscale description: How to use Shadowscale, our previous app for iPhone and iPad: add your servers, connect, keep the server list up to date, and control it with Shortcuts. --- 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](/en/docs/floxcore) or [12VPX NEO](/en/docs/12vpx-neo). This page explains how to use Shadowscale if you already do. AUTOMATIC_TABLE_OF_CONTENTS ## Guides - [Smart Routing and other settings](/en/docs/shadowscale/settings) - [Troubleshooting](/en/docs/shadowscale/troubleshooting) ## 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 1. Install [Shadowscale](https://apps.apple.com/us/app/shadowscale/id1408634435) from the App Store and open it once. 2. Open the [Shadowscale setup guide](/en/setup/ios/shadowscale) and sign in. It shows a QR code. 3. 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. 4. 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 1. On **Home**, tap a server so the checkmark is next to it. 2. Tap **Connect**. 3. 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](/en/docs/shadowscale/troubleshooting#the-server-list-wont-update). ## 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](/en/docs/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](/en/setup/ios/floxcore): it can't use Shadowscale's server list. Then delete Shadowscale, and remove its entry on our [Devices page](/en/devices) so it doesn't count towards your device limit.