Error code fixes

Launcher & bootPND-1xxx

PND-1001 Fatal #

Administrator declined

Do these in order, stop as soon as it works:

1. Re-launch Pindrift and click 'Yes' on the UAC prompt.
2. If UAC keeps prompting, sign in to a Windows account that has Administrator rights, then re-launch.
3. If you cannot get an admin account, ask your IT admin to grant local-admin rights to your account.

PND-1002 Fatal #

UAC elevation call failed

Do these in order, stop as soon as it works:

1. Right-click the Pindrift shortcut and choose 'Run as Administrator'.
2. If that fails on a corporate or school PC, ask your IT admin to whitelist 'Pindrift.exe' for elevation.
3. If you still cannot elevate, email support@pindrift.app for a portable build that does not require admin.

PND-1010 Fatal #

Apple Devices missing

Do these in order, stop as soon as it works:

1. Install 'Apple Devices' from the Microsoft Store (ms-windows-store://pdp/?productid=9NP83LWLPZ9K).
2. On older Windows 10 without that app, install iTunes from apple.com instead, it ships the same driver.
3. Re-launch Pindrift, then unplug and replug the iPhone so Windows re-detects it.

PND-1011 Warning #

Apple Mobile Device Service not running

Do these in order, stop as soon as it works:

1. Open Services.msc, find 'Apple Mobile Device Service', set Startup Type to Automatic, and click Start.
2. Or run as Admin: net start "Apple Mobile Device Service".
3. If it stops again after reboot, whitelist %CommonProgramFiles%\Apple\Mobile Device Support\ in your antivirus.
4. If that does not work, do a full reboot to reset the service.

PND-1020 Fatal #

tunneld didn't come up

Do these in order, stop as soon as it works:

1. Close other iOS tools holding the lockdown port: Xcode, iMazing, 3uTools, iTunes, AltStore, libimobiledevice.
2. Open Task Manager and end any stale 'pymobiledevice3.exe' or 'tunneld.exe' processes.
3. Reboot the PC if it still fails.
4. If it recurs, whitelist %LOCALAPPDATA%\Pindrift\ in your antivirus.

PND-1021 Fatal #

Pindrift daemon didn't come up

Do these in order, stop as soon as it works:

1. Run as Admin: netstat -ano | findstr :49152 to find the process holding port 49152.
2. End that PID in Task Manager, or run taskkill /F /PID <pid>.
3. End any leftover 'python.exe' or 'pindrift-daemon.exe' from a previous Pindrift.
4. Reboot if you cannot identify the holder.
5. If it recurs, whitelist %LOCALAPPDATA%\Pindrift\ in your antivirus.

PND-1030 Info #

Another Pindrift is already running

Do these in order, stop as soon as it works:

1. Click the ^ in the system tray (bottom-right) and click the Pindrift icon to bring its window forward.
2. If the icon is missing, open Task Manager (Ctrl+Shift+Esc), go to Details, and end every 'Pindrift.exe' tree.
3. Re-launch Pindrift.

DaemonPND-2xxx

PND-2001 Error #

Daemon unreachable

Do these in order, stop as soon as it works:

1. Right-click the tray icon, choose Quit, then re-launch Pindrift.
2. Whitelist %LOCALAPPDATA%\Pindrift\ in your antivirus, which often blocks loopback to Python.
3. Pause any external VPN to rule out a split-tunnel misconfig. Tailscale is fine.
4. If it keeps failing, open Settings > Open Pindrift logs folder, zip 'daemon.log', and email it with this code to support@pindrift.app.

PND-2002 Error #

Unknown device

Do these in order, stop as soon as it works:

1. For USB: unplug and replug the iPhone into a different port (a rear USB 3 port works best).
2. Swap to a known-good Apple data cable, since cheap cables are often charge-only.
3. On the phone, tap 'Trust This Computer' when iOS prompts.
4. For Wi-Fi: put the iPhone and PC on the SAME network (not phone-on-cellular).
5. Disable any external VPN, which breaks wireless discovery. Tailscale is fine.

PND-2003 Error #

Operation is iOS-only

Do these in order, stop as soon as it works:

1. Pick an iPhone from the device list and retry, since Pindrift only teleports iPhones (no Android).
2. If your only device looks like an iPhone but errors out, delete %USERPROFILE%\.pymobiledevice3\.
3. Re-pair the iPhone from the Device tab.

PND-2010 Error #

Settings write failed

Do these in order, stop as soon as it works:

1. Free up at least 1 GB of disk space.
2. Right-click %LOCALAPPDATA%\Pindrift\ > Properties > Security and confirm your user has Modify rights.
3. Exclude %LOCALAPPDATA%\Pindrift\ from OneDrive sync if a redirected folder is locking it.
4. If the folder is missing, recreate it and Pindrift will repopulate it on next launch.

PND-2020 Error #

Phone snapshot write failed

Do these in order, stop as soon as it works:

1. Free up at least 1 GB of disk space.
2. Confirm %LOCALAPPDATA%\Pindrift\phone-snapshot.json is writable.
3. Delete phone-snapshot.json if it is locked, and Pindrift will regenerate it on next save.
4. Remove any backup .json files in the same folder if needed.

Tunnel & dev imagePND-3xxx

PND-3001 Error #

No tunnel for this device

Do these in order, stop as soon as it works:

1. For USB, unplug and replug the iPhone into a different port (rear USB 3 beats front-panel).
2. Tap Trust on the iPhone if iOS prompts.
3. For wireless, put the iPhone and PC on the SAME Wi-Fi (5GHz preferred).
4. Disable any external VPN (NordVPN, ExpressVPN, etc.) and retry. Tailscale is fine.
5. If it still fails, restart the iPhone and try again.

PND-3002 Error #

RSD connect failed

Do these in order, stop as soon as it works:

1. Replug the cable and try a different USB port.
2. Swap to a known-good DATA cable (Apple originals work; many cheap cables are charge-only).
3. Confirm iTunes or Apple Devices can see the phone with the same cable; if not, it is the cable or port.
4. If only one phone fails, gently clean its charging port with a wooden toothpick.
5. If it persists, reboot the phone.

PND-3010 Error #

DeveloperDiskImage missing

Do these in order, stop as soon as it works:

1. Confirm the PC has a working internet connection.
2. Unplug and replug the iPhone to trigger the DDI download (~60 MB).
3. Whitelist developer.apple.com and cdn-apple.com in your firewall or antivirus.
4. Disable any external VPN for the first connect, then retry. Tailscale is fine.
5. If you are on an iOS beta, downgrade to the stable iOS release.

PND-3020 Error #

Developer Mode is off

Do these in order, stop as soon as it works:

1. On the iPhone, open Settings > Privacy & Security > Developer Mode.
2. Toggle Developer Mode ON and tap Restart.
3. After reboot, enter your passcode to confirm Developer Mode.
4. If the Developer Mode item is missing, plug the iPhone into Pindrift once, then check Settings again.

Wireless pairingPND-4xxx

PND-4001 Error #

Wireless flag flip failed

Do these in order, stop as soon as it works:

1. Unlock the iPhone (screen on, passcode entered).
2. On Wi-Fi, put the iPhone and PC on the SAME network (not cellular, not two networks).
3. If you tapped Don't Trust, plug in via USB and tap Trust this time.
4. Disable any external VPN and retry. Tailscale does not interfere.
5. If it still fails, reboot the iPhone and the PC.

PND-4002 Error #

Wireless pair handshake failed

Do these in order, stop as soon as it works:

1. Unlock the iPhone.
2. If you tapped Don't Trust, unplug and replug the cable, then tap Trust when iOS asks again.
3. Disable any external VPN for first-time pairing. Tailscale is fine.
4. If iOS keeps refusing Trust, open Settings > General > Transfer or Reset iPhone > Reset > Reset Network Settings, then retry.

PND-4003 Warning #

Bonjour Service not running

Do these in order, stop as soon as it works:

1. Open Services.msc, find Bonjour Service, set Startup Type to Automatic, and click Start.
2. Or run as Admin: net start "Bonjour Service".
3. Disable any external VPN that blocks mDNS, or enable Allow LAN traffic in its settings. Tailscale is fine.
4. If it still won't start, check Event Viewer (Windows Logs > System) for the failure reason.

PND-4004 Warning #

Bonjour Service missing

Do these in order, stop as soon as it works:

1. Install Apple Devices from the Microsoft Store (ms-windows-store://pdp/?productid=9NP83LWLPZ9K).
2. Reboot Windows so the service registers.
3. If you have iTunes from apple.com instead, repair that install to restore Bonjour Service.

PND-4005 Error #

Wireless pair record corrupt

Do these in order, stop as soon as it works:

1. Delete %USERPROFILE%\.pymobiledevice3\remote_<udid>.plist (delete all of them if unsure which is yours).
2. In Pindrift, open the Device tab and click Re-pair.
3. Tap Trust on the iPhone when prompted.
4. Disable any external VPN during re-pair. Tailscale is fine.
5. If it still corrupts, sign out of iCloud briefly, re-pair, then sign back in.

Kill switchPND-5xxx

PND-5001 Warning #

Kill-switch sidecar failed to start

Do these in order, stop as soon as it works:

1. Confirm the PC has working LAN by loading any local page in a browser.
2. Restart Pindrift to retry binding the kill-switch port.
3. Open your VPN settings and enable 'Allow LAN traffic', or pause the VPN. Tailscale is fine.
4. Allow Pindrift on Private networks by re-adding the Windows Firewall rule from the first-launch prompt.

PND-5002 Warning #

TLS cert generation failed

Do these in order, stop as soon as it works:

1. Confirm %LOCALAPPDATA%\Pindrift\killswitch-tls\ is writable and the disk has free space.
2. Delete the killswitch-tls folder to force a fresh cert on next restart.
3. On the iPhone kill-switch page, tap Visit Site Anyway if you see a 'Not Private' warning.
4. If it persists, whitelist %LOCALAPPDATA%\Pindrift\ in your antivirus.

PND-5003 Error #

Kill-switch unauthorized

Do these in order, stop as soon as it works:

1. Open Pindrift on the PC and go to the Kill Switch tab.
2. Re-scan the fresh QR code with your iPhone camera, using the live screen, not a screenshot.
3. Tap Share > Add to Home Screen to save the new URL so it always opens with the fresh token.

PND-5004 Error #

Kill-switch restart-source missing

Do these in order, stop as soon as it works:

1. Open Pindrift on the PC and re-pick the favorite or route you want.
2. Pull-to-refresh the iPhone kill-switch page in Safari.
3. Turn off 'Auto-clean unused favorites' in Pindrift Settings to prevent accidental deletes.

TeleportingPND-6xxx

PND-6001 Error #

Couldn't reach iPhone to set location

Do these in order, stop as soon as it works:

1. Replug the USB cable, or for wireless, confirm the iPhone stayed on Wi-Fi and did not switch to cellular.
2. If you just plugged in, wait 5-10 seconds for the tunnel to come up.
3. Try the teleport again.
4. Disable any external VPN and retry. Tailscale is fine.

PND-6002 Error #

Couldn't reach iPhone to clear location

Do these in order, stop as soon as it works:

1. Reconnect the iPhone over USB or Wi-Fi and click Stop again.
2. If the phone is unreachable, power-cycle it: hold Side + Volume Down on iPhone X and newer, or hold Side on iPhone SE/8.
3. Refresh any app still showing the old spot, like Snapchat or Pokemon Go.

PND-6003 Error #

Teleport worker crashed

Do these in order, stop as soon as it works:

1. Try the teleport again, it is almost always a transient hiccup.
2. Restart Pindrift between attempts to clear a stale lockdown handle.
3. Update to the latest Pindrift release.
4. If it crashes 3+ times, open Settings > Open Pindrift logs folder, zip daemon.log and teleport.log, and email support@pindrift.app with this code.

PND-6010 Warning #

Coordinates out of range

Do these in order, stop as soon as it works:

1. Use the map picker instead of typing coordinates manually.
2. If you copied coordinates, paste them in decimal degrees like 37.7749, -122.4194, not degrees-minutes-seconds.
3. Enter latitude first, then longitude, to avoid a swapped pair.

Billing & licensingPND-7xxx

PND-7001 Error #

Stripe checkout failed

Do these in order, stop as soon as it works:

1. Wait a minute, then start checkout again.
2. Open checkout in Chrome or Edge if your browser blocks third-party cookies (Brave Strict, Safari).
3. Switch off your work or school network, for example use a phone hotspot.
4. If it still fails, email support@pindrift.app with this code and your Pindrift account email.

PND-7002 Warning #

Restore code email blocked

Do these in order, stop as soon as it works:

1. Wait 10 minutes, then request the restore code again.
2. Check your spam or junk folder for an email from no-reply@pindrift.app.
3. Switch your Pindrift account to a Gmail or iCloud address if your provider keeps filtering.
4. If nothing arrives within 30 minutes, email support@pindrift.app from your purchase email with this code.

PND-7003 Error #

License activation locked

Do these in order, stop as soon as it works:

1. Wait until the cooldown ends, the date is shown in the error toast.
2. If your old PC is dead, stolen, or sold, email support@pindrift.app with proof of transfer for a manual move within 24h.

PND-7010 Info #

Trial expired

Do these in order, stop as soon as it works:

1. Click 'Get Access' in Pindrift and pick the 10-Day Pass ($3.99), Monthly ($5/mo), Yearly ($25/yr), or Lifetime ($50 once).
2. If you already paid on another PC, click 'Restore' and enter your purchase email.
3. Paste the emailed code back into Pindrift to unlock teleporting.

Auto-updatePND-8xxx

PND-8001 Warning #

Update download failed

Do these in order, stop as soon as it works:

1. Confirm your internet works by loading github.com in a browser.
2. Keep using the current version, Pindrift retries the update on next launch.
3. Switch to home Wi-Fi if a work or school network blocks GitHub downloads.
4. If that does not work, download the installer from pindrift.app/download.

PND-8002 Error #

Update install failed

Do these in order, stop as soon as it works:

1. Right-click the system-tray icon and choose Quit to close Pindrift fully.
2. Wait 10 seconds, then end any stale 'Pindrift.exe' or 'pindrift-daemon.exe' in Task Manager.
3. Re-launch Pindrift.
4. If that does not work, download the installer from pindrift.app/download and run it.

App & UIPND-9xxx

PND-9000 Error #

Unexpected error

Do these in order, stop as soon as it works:

1. Try the action again.
2. If it keeps happening, open Settings > Collect logs to save a diagnostic file to your Downloads.
3. Report it on the Pindrift Discord with this code and the saved log attached.

PND-9001 Error #

Daemon API call failed

Do these in order, stop as soon as it works:

1. Right-click the tray icon > Quit, then re-launch Pindrift.
2. Whitelist %LOCALAPPDATA%\Pindrift\ in your antivirus.
3. If it persists, open Settings > Open Pindrift logs folder, zip 'daemon.log', and email support@pindrift.app with this code.

PND-9002 Error #

Map tiles failed to load

Do these in order, stop as soon as it works:

1. Load any website to confirm your internet works.
2. Change the map in Settings > Map style to use a different tile provider.
3. Wait 1-2 minutes and reload if the server is rate-limiting you.
4. If a firewall or VPN blocks tile.openstreetmap.org, whitelist it or switch map style.

PND-9003 Error #

Search service down

Do these in order, stop as soon as it works:

1. Wait a moment and search again.
2. Drop a pin directly on the map instead.
3. Or paste coordinates in decimal degrees (lat,lon) into the search box to bypass the geocoder.

PND-9004 Error #

Routing service down

Do these in order, stop as soon as it works:

1. Wait 30 seconds and try again.
2. Toggle 'Follow Road' OFF in the teleport panel to use straight-line paths instead.

PND-9010 Warning #

localStorage write failed

Do these in order, stop as soon as it works:

1. Free up at least 1 GB of disk space, then restart Pindrift.
2. Exclude %LOCALAPPDATA%\Pindrift\ from OneDrive sync if you use a redirected or network profile.

PND-9020 Error #

Saved-route file write failed

Do these in order, stop as soon as it works:

1. Right-click %LOCALAPPDATA%\Pindrift\routes\ > Properties > Security and confirm your user has Modify rights.
2. Free up at least 1 GB of disk space.
3. Exclude %LOCALAPPDATA%\Pindrift\routes\ from OneDrive sync.
4. If the folder is missing, create it and Pindrift will populate it on next save.

PND-9021 Warning #

Saved-route file unreadable

Do these in order, stop as soon as it works:

1. Open the routes folder from Routes tab > Open routes folder.
2. Delete any 0-byte file.
3. Re-export foreign files from the source app as 'GPX Track' (not 'GPX Route') and re-import.
4. If a file still errors, open it in a text editor and confirm it has <trkpt> elements.

PND-9022 Error #

Route recording sync failed

Do these in order, stop as soon as it works:

1. Check your PC's internet connection and wait for it to sync automatically.
2. Open the Pindrift phone app, go to the Recordings tab, and pull-to-refresh to force a re-sync.
3. If your network blocks pindrift.app, whitelist it.

PND-9023 Warning #

Recorded track was empty

Do these in order, stop as soon as it works:

1. On the iPhone, open Settings > Privacy & Security > Location Services > Pindrift and set it to 'Always'.
2. Confirm Location Services is ON at the top of that screen.
3. Record again while physically moving at least 10 meters, ideally outdoors.

PND-9030 Error #

No device ready to teleport

Do these in order, stop as soon as it works:

1. Plug your iPhone into the PC with a cable that charges and syncs.
2. Unlock the phone and tap 'Trust' if prompted.
3. Wait for it to appear in the Device panel, then try again.
4. If it still won't show, use a USB port directly on the PC (not a hub) and confirm the free 'Apple Devices' app is installed.

PND-9031 Error #

Developer Mode is off

Do these in order, stop as soon as it works:

1. On the iPhone, open Settings > Privacy & Security > Developer Mode and turn it ON.
2. Restart the phone when prompted, then tap 'Turn On' again after it reboots.
3. Reconnect to Pindrift and try the teleport again.
4. If 'Developer Mode' isn't in that menu, connect the phone to Pindrift once to make the toggle appear.