SpellVPN icon

SpellVPN User Guide

User Guide

Follow the same real workflow shown in the app: Dashboard → + → Import → Nodes → select a node → Dashboard → Connect. This guide also covers subscription updates, routing and DNS, diagnostics, backups, and the Pro / Ultra boundaries.

SpellVPNSupportPrivacy Policy
Quick paths

iOS: Dashboard -> + -> Import -> Nodes -> select a node -> Dashboard -> Connect. Mac: Configurations or menu bar import -> choose a profile and node -> Connect -> use Logs, Network Tools, or diagnostics if the tunnel fails.

Website information updated September 12, 2026

Editions and version information

SpellVPN Tool · iOS / Mac

SpellVPN Tool is a paid, ad-free configuration client for iOS and macOS. It supplies no server nodes, preset source catalog, or node-service subscription. Import your own configuration, nodes, or subscription URL that you are authorized to use. The client can establish a VPN connection using the imported configuration; it is not an offline-only file viewer.

SpellVPN Ultra · iOS

SpellVPN Ultra is the iOS edition with advertising and optional App Store auto-renewing subscriptions. A valid subscription removes ads and gives access to Curated Sources and Exclusive Lines supplied through the service. Ultra also supports users' own imports. These service-provided configurations are an actual subscription benefit, not just ad removal.

Website information updated September 12, 2026

Configuration sources and network requests

Configuration sources and network requests

SpellVPN Tool contacts the subscription, DNS, and server endpoints in your imported configurations. SpellVPN Ultra also requests Curated Sources and Exclusive Lines from apixx.spellv.com when using those features, and may then contact the returned subscription and node endpoints. Remote services receive the network information needed to handle these requests, such as IP address and HTTP request metadata. VPN traffic is processed by the servers selected in the active configuration. This is separate from App Store purchase processing and Ultra advertising.

Ultra subscriptions and access

In SpellVPN Ultra, open Settings → Subscription → Ultra Subscription to view the available plans, purchase, or restore a purchase. With an active entitlement, use Curated Sources or Exclusive Lines in the normal interface. My Imports remains separate from service-provided content. If a purchase or source cannot be loaded, contact support with the app version and error text; do not send passwords or complete subscription URLs.

Ultra subscriptions and access

Weekly, monthly, quarterly, and yearly auto-renewing plans are handled by Apple. The App Store purchase sheet shows the actual price, period, and renewal terms. You can restore eligible purchases in the app and manage subscriptions in your Apple account. Source contents and connectivity can change; access is not a promise of permanent nodes, unrestricted traffic, or a particular region's availability.

1

Before You Start

  1. Prepare a compatible sing-box JSON file, Clash/Mihomo YAML, subscription URL, proxy URI, QR code, clipboard text, local file, or Wi-Fi upload file from your own provider.
  2. For a complete VPN configuration, make sure the imported sing-box profile contains a tun inbound and at least one usable proxy outbound. A node link can be imported first, then converted into the active runtime configuration.
  3. Confirm that the server or subscription endpoint is reachable from your network before importing it. SpellVPN does not create accounts, servers, credentials, or working traffic for an invalid provider.
  4. Tool: paid, ad-free, user-supplied configurations only. Ultra on iOS: advertising and optional subscriptions that remove ads and provide Curated Sources and Exclusive Lines.
SpellVPN dashboard and connection overview.
SpellVPN dashboard and connection overview.
2

Import a Configuration

  1. Open SpellVPN, stay on Dashboard, and tap the + button in the top-right corner. Choose QR scan, photo QR, clipboard, Files, Wi-Fi Upload, subscription URL, proxy link, system share, or URL scheme.
  2. For a subscription, paste the complete URL and wait for the download and parser result. For a single node, paste a proxy URI supported by the submitted build, such as ss://, vmess://, vless://, trojan://, hysteria2://, hy2://, tuic://, socks://, socks5://, http://, or https:// proxy links.
  3. Review the detected configuration name, protocol, server, port, transport, TLS, and rule details before saving. Do not treat a displayed node name as proof that the remote server works.
  4. If the import fails, check for an expired or blocked subscription URL, malformed JSON/YAML, Base64 text with extra characters, unsupported fields, or missing server and port. Open Logs for the exact parser message.
  5. OpenVPN .ovpn and IKEv2 .mobileconfig are detected with a clear limitation because this build does not include those separate native profile cores.
Import flow for QR codes, links, clipboard text, and files.
Import flow for QR codes, links, clipboard text, and files.
3

Manage Subscriptions and Nodes

  1. After a successful subscription import, open Settings → Network & Configuration → Manage Subscriptions. Each saved URL has its own group, so importing or updating one group does not replace unrelated groups.
  2. Open a group to update its URL, copy the URL, rename the group, or delete it. Wait for the result message and check how many nodes were imported or skipped.
  3. Open Nodes to search by name, filter by protocol, expand a group, select the active node, edit supported outbound fields, mark favorites, export a node as JSON, or show a node QR code.
  4. Use Config to review the active JSON and supported route, DNS, TUN, IPv6, MTU, include-route, and exclude-route settings before connecting.
  5. Exported node links can contain server addresses, ports, and credentials. Share them only with people or apps you trust, and do not publicly distribute configs, subscriptions, or credentials that are not yours.
Manage imported nodes, favorites, single-node export, and node QR codes.
Manage imported nodes, favorites, single-node export, and node QR codes.
4

Connect and Disconnect

  1. Select a valid saved configuration and node, return to Dashboard, and tap Connect.
  2. Approve the iOS VPN permission prompt the first time a Packet Tunnel profile is installed. The iOS status bar VPN indicator is controlled by iOS.
  3. When the app and iOS both show Connected, open a real website test or use HTTP, TCP, DNS, and IP checks in Network Tools. A system Connected status only confirms that the tunnel profile started; it does not prove that the selected remote node is usable.
  4. Use Settings → Network & Configuration → Manage DNS to review DNS mode, bootstrap resolvers, hosts, Fake-IP, and IPv6 choices. Check the active routing mode before changing the node.
  5. Use the same control to disconnect. Do not repeatedly tap Connect while the app is still in Connecting; wait for the result or open Logs.
Return to the dashboard to connect, disconnect, and confirm the active status.
Return to the dashboard to connect, disconnect, and confirm the active status.
5

Use SpellVPN on macOS

  1. Import a supported configuration from a file, clipboard, QR image, proxy link, WireGuard text, or HTTP/HTTPS remote URL, then save it as a profile.
  2. Choose a profile and node from Dashboard, Nodes, or the macOS menu bar. The app starts a real native macOS Packet Tunnel and does not provide its own VPN account or traffic network.
  3. Use Configurations and Settings to validate and edit TUN, route, DNS, IPv6, MTU, split tunnel, Fake-IP, DNS hijack, privacy filters, and Relay / MultiHop before the next connection.
  4. Use Network Tools, protocol health checks, traffic checks, logs, diagnostics, plain JSON backup, or password-protected AES-GCM backup when troubleshooting. OpenVPN .ovpn and IKEv2 .mobileconfig are not supported by this target.
SpellVPN macOS dashboard and menu bar workflow.
macOS App Store build
6

Diagnostics and Network Tools

  1. If the VPN is connected but Google, YouTube, or other websites do not load, first check the active node, route mode, DNS settings, TLS/transport fields, server port, and the node protocol test. Switch to another node before changing several settings at once.
  2. Use the Network Tools available in the submitted build, including TCP Ping, DNS lookup, IP lookup, Whois, GeoIP, TLS test, HTTP test, TCP port check, UDP send, IPv6 visibility check, and speed test.
  3. Use Logs after an import, Ping, or connection attempt. Filter by category and time, then use Export Diagnostics Report to share a text report with support.
  4. In node lists, a blank or 0 ms result means the endpoint was not measured, failed, or requires an active UDP/QUIC protocol test. It is not proof of a zero-latency connection. App Store builds use TCP reachability instead of raw ICMP sockets.
  5. The current App Store build does not expose traceroute, WebRTC leak testing, MITM, rewrite scripts, native OpenVPN, or native WireGuardKit.
Use logs and diagnostics to troubleshoot connection issues.
Use logs and diagnostics to troubleshoot connection issues.
7

Backups, Data, and Editions

  1. Use Settings → Data & Sync → Export App Data File to create a JSON backup, or use iCloud Drive backup when the signed App ID has the required iCloud Documents capability. The backup can include configs, nodes, subscriptions, rules, DNS, route mode, adapter settings, and statistics.
  2. Logs stay on device unless you export or share them. Clearing local data does not delete iCloud Drive backup files. The iOS VPN permission and active system tunnel are not portable backup data.
  3. On Ultra, open Settings → Subscription → Ultra Subscription to view StoreKit prices, purchase, restore, or manage the subscription. The four plan IDs are weekly, monthly, quarterly, and yearly products managed by Apple.
  4. Tool: paid, ad-free, user-supplied configurations only. Ultra on iOS: advertising and optional subscriptions that remove ads and provide Curated Sources and Exclusive Lines.
Settings show edition details, privacy status, Wi-Fi Upload, iCloud Drive backups, local reset, and network tools.
Settings show edition details, privacy status, Wi-Fi Upload, iCloud Drive backups, local reset, and network tools.
For help, contact balamanigill@gmail.com.

iOS Pro is a paid ad-free download; iOS Ultra is free with Yandex/AdMob ads and optional auto-renewing subscriptions. The macOS build is separate and has no advertising SDKs, analytics SDKs, StoreKit products, subscriptions, or built-in VPN account.