How to Use StormDNS on Android with WhiteDNS
StormDNS is a DNS-tunnel VPN protocol that encodes your traffic as DNS queries, making it nearly invisible to network filters. This guide shows you how to set it up on Android using the WhiteDNS app.
Prerequisites
- An active PremierVPN subscription
- Your StormDNS Hostname and Encryption Key from the StormDNS page in your PremierVPN dashboard
- An Android device
Step 1 — Download WhiteDNS
Head to the WhiteDNS GitHub releases page and download the latest APK:
Install the APK on your Android device. You may need to allow installation from unknown sources in your device settings.
Step 2 — Create a Connection Profile
Open WhiteDNS and go to the Profiles tab.
Under Connections, tap CREATE.
Fill in the fields:
- Name — Enter any name you like (e.g. "PremierVPN StormDNS")
- Domain — Paste your personal StormDNS hostname from the StormDNS page in your dashboard
- Encryption Key — Paste your encryption key from the same page
- Encryption Method — Make sure this is set to XOR
Then tap SAVE.
Important: Your Domain and Encryption Key are unique to your account. You can find them on the StormDNS page in your PremierVPN dashboard.
Step 3 — Add DNS Resolvers
Your StormDNS profile has been created. Now tap on Resolver.
Tap CREATE to add a new resolver list.
First, tap CLEAR to remove any default resolvers.
Next, download the latest verified Iran resolvers file from GitHub:
Download verified-iran-resolvers.txt →
Then tap IMPORT FILE and select the downloaded file.
Give the resolver profile a name and tap SAVE.
Your resolvers have been added. Now head back to the Connect tab.
Step 4 — Connect
Select Full VPN if you want to tunnel your entire device through StormDNS, then tap CONNECT.
Wait a few minutes while StormDNS scans resolvers and finds working ones. You can see the progress in the Logs tab — look for lines with a ✅ icon, which indicate valid resolvers.
After a few minutes, your connection will start once enough valid resolvers are found.
You're connected! You can now browse freely.
Pro Tip — Speed Up Future Connections
Wait for the client to finish scanning all DNS resolvers before proceeding.
Once the scan is complete, you'll see how many valid resolvers were found. In this example, 370 out of the full list are working.
Tap on the valid resolver count, then tap Copy to copy just the working resolvers.
Now create a new Resolver profile and paste only these working resolvers. This way, your next connection will start much faster — the client won't need to scan thousands of resolvers each time, only the ones that are already verified to work on your network.
Troubleshooting
- No valid resolvers found? — Your ISP may be blocking DNS queries to the resolvers in the list. Try using a different mobile network or Wi-Fi connection. You can also use the DNS Scanner in your PremierVPN dashboard to find resolvers that work from your specific location.
- Connection is slow? — DNS tunnelling is inherently slower than standard VPN protocols like WireGuard. This is the trade-off for being able to bypass restrictive network filters. For best performance, use the optimised resolver list (see Pro Tip above).
- Connection drops frequently? — Try switching to a different StormDNS server from your StormDNS dashboard. Some servers may perform better depending on your network conditions.
Need Help?
If you're having trouble getting StormDNS working, open a support ticket and include your ISP name, mobile operator (if applicable), and any error messages from the WhiteDNS Logs tab.