Troubleshooting

If profile installation or redirect fails, try the steps below

Safari is required

In-app browsers (WeChat, QQ, etc.) cannot install configuration profiles. Tap the menu and choose "Open in Safari", or paste the link into Safari's address bar.

HTTPS is required

iOS only posts device info over HTTPS. Open the site via a public HTTPS URL (not http://127.0.0.1) and ensure your reverse proxy forwards POST requests to /receive/*.

No redirect after installation

If the profile installed but you were not redirected: 1) Confirm site.origin matches your public HTTPS URL; 2) Check frp/nginx body size limits for POST; 3) Go home and download a new profile.

Result page says record not found

The server may have restarted, the record expired (default 7 days), or the link is wrong. Go home and install a new profile to get a fresh UDID.

Profile shows as unsigned

Unsigned profiles still work; iOS may show an unverified warning. Configure signing.cert and signing.key for PKCS#7 signing to show as verified.

Passcode prompt during install

iOS requires your device passcode (not your Apple ID password) to confirm profile installation. This is normal.