Windows install — step by step
System requirements
- Windows 10 (build 19044 or later) or Windows 11.
- x86-64 architecture (Intel/AMD 64-bit). ARM64 build coming Q3 2026.
- Administrative privileges for the initial install (to register the VPN network adapter).
- ~50 MB free disk after install.
Install steps
- Click Download for Windows. The signed .exe (~7 MB) downloads.
- Double-click
GhostShield-Setup.exe. Windows SmartScreen may show a warning the first time; click “More info” → “Run anyway.” The signature is verifiable — see the SHA-256 hash and code-signing certificate below. - The installer prompts for User Account Control (UAC). Click “Yes” — this is required to install the WireGuard network driver.
- Choose install location (default:
C:\Program Files\GhostShield VPN). Click Next. - Wait ~10 seconds for the install to complete. The app launches automatically.
- Sign in with your GhostShield account email and password (or sign up if you do not have one).
- Click any server in the list. The tunnel comes up within 2-3 seconds.
Verifying the installer
For users who want to confirm the installer is unmodified:
- SHA-256: Published in the release notes on GitHub before every release. Verify with PowerShell:
Get-FileHash GhostShield-Setup.exe -Algorithm SHA256 - Code signature: Right-click the .exe → Properties → Digital Signatures. The certificate should read “GhostShield Ltd” with a valid Sectigo / DigiCert chain.
Android install — step by step
System requirements
- Android 8.0 (API level 26) or later.
- ~30 MB free storage.
- For sideloaded APK: “Install unknown apps” permission for your browser or file manager.
Install from Google Play
- Open Google Play and search for “GhostShield VPN.”
- Tap Install. ~12 MB.
- Open the app. Sign in or sign up.
- Tap Connect. Android prompts for VPN permission — tap Allow. This permission is granted once.
- The tunnel is active. The Android system shows a small key icon in the status bar.
Sideload the APK
Recommended in regions where Google Play is restricted (China, parts of Russia, Iran):
- Download the APK from /api/download/apk.
- Tap the downloaded file. If Android blocks the install, go to Settings → Apps & notifications → Special app access → Install unknown apps, and grant permission to your browser or file manager.
- Install completes in ~5 seconds.
- Open the app, sign in, tap Connect, grant the VPN permission.
iOS — connect via the WireGuard app
The native GhostShield app for iPhone and iPad is still in development. Until it ships, iOS users on a paid plan connect using the official WireGuard app:
- Install WireGuard from the App Store (free, by WireGuard LLC).
- Sign in to your GhostShield dashboard from any browser.
- Open the Devices tab and find iPhone, iPad & Mac setup.
- Pick a server location and select Generate configuration. A QR code appears.
- In the WireGuard app, tap + → Create from QR code. Scan the code.
- Toggle the new configuration on. iOS prompts for VPN permission once.
Switching server locations means generating a new configuration, which replaces the previous one — only one manual configuration is active per account at a time. If the connection stops working after a long period without use, generate a fresh configuration from the same screen.
Linux — WireGuard config files
There is no GhostShield client for Linux. Paid users can request a WireGuard configuration for wg-quick by emailing info@ghostshield.ai — drop the .conf in /etc/wireguard/ and run sudo wg-quick up ghostshield.
Routers — OpenWrt and stock firmware
Compatible routers running OpenWrt (or any firmware with WireGuard support) can be configured with a GhostShield WireGuard endpoint. Every device on the router's LAN then routes through the VPN. Detailed setup guides for Asus, GL.iNet, OpenWrt, and pfSense are at /learn/wireguard-vs-openvpn.
Troubleshooting common install errors
Windows: “The installer cannot install the network adapter”
Caused by conflicting VPN software (typically an old OpenVPN or NordVPN installation). Uninstall the conflicting VPN, reboot, then retry GhostShield's install.
Android: “App not installed” on sideloaded APK
Usually means an existing GhostShield install has a different signing certificate. Uninstall the existing version (Settings → Apps → GhostShield → Uninstall), then retry.
iOS: the tunnel is on but nothing loads
Usually means the configuration was replaced — generating a new one, on any device, deactivates the previous configuration. It can also happen after a long stretch without connecting. Open the Devices tab of your dashboard and generate a fresh configuration.
macOS: VPN won't turn on after install
macOS may require explicit permission before a VPN app can create a tunnel. Open System Settings → Privacy & Security, scroll down, and allow the blocked GhostShield entry.
Uninstalling
Windows: Settings → Apps → GhostShield VPN → Uninstall. The uninstaller removes the binary, the WireGuard network adapter, and the kill-switch firewall rules.
Android: Settings → Apps → GhostShield → Uninstall.
macOS: drag GhostShield from Applications to the Trash, then remove the VPN profile in System Settings → VPN.
iPhone and iPad: delete the configuration in the WireGuard app, then revoke the device in the GhostShield dashboard.
What gets installed
The Windows installer adds:
- The GhostShield application binary (~25 MB on disk).
- A WireGuard network adapter (a virtual NIC).
- Two Windows Filtering Platform (WFP) firewall callouts (kill switch).
- A Start Menu shortcut.
The installer does NOT add: browser extensions, telemetry agents, persistent background services beyond the WireGuard tunnel manager, or third-party libraries that phone home.