Documentation

What Porthole says

The messages Porthole shows when something is wrong, copied from the app so you can find the one in front of you. A … stands for a name or number that changes.

Install check

JIT cannot be switched on

This copy was signed without the “debuggable” permission (get-task-allow), which comes with a distribution or enterprise certificate. No tool can turn JIT on for it. Sign it with a development certificate and profile.

JIT can be switched on

This copy is signed so a debugger may attach.

Extra memory allowed

Games may use more memory than a normal app.

Extra memory is not allowed

Big games may close on their own without warning.

Large address space allowed

Games can map the memory the engine reserves for them.

Large address space is not allowed

Some games will not start, or close shortly after they do.

Porthole's own private link is not available

… was signed without the “Network Extensions” permission, so iOS will not run Porthole's own tunnel. You do not need it: use LocalDevVPN instead (turn on “Use LocalDevVPN instead” in Settings › JIT and connection, and switch LocalDevVPN on before you press Play)\(usingLocalDev ?

The private link was signed by another team

The tunnel extension and the app were signed with different profiles, so iOS will not start it. Sign both with the same certificate and team.

The private link can start

The tunnel extension carries the Network Extensions permission.

No private link inside this install

Run LocalDevVPN when a tool needs the private link to switch JIT on. Porthole does not start its own VPN, so your own VPN is left alone.

The JIT helper has no signature

iOS will not run the JIT helper. Install again so both the app and the helper are signed.

The JIT helper's profile has expired

Sign Porthole again to renew it.

No JIT helper inside this install

Switch JIT on with StikDebug or another tool. “Porthole does it” is not available in this install.

No download card extension inside this install

Downloads show iOS's own download card (percentage, size and speed) instead of the one with Pause and Cancel buttons. It saves an App ID.

Donor memory can start

The Memory Host extension is inside and signed.

No donor memory extension inside this install

Settings > Advanced > Engine options > Memory > Donor memory does nothing in this install. It saves an App ID.

Donor memory cannot start

The Memory Host extension is inside, but …, so iOS will not run it. Sign Porthole again, or install without it to save an App ID.

The signature has expired

Sign Porthole again to keep opening it.

A game or download stopped

A stick was moving. Put the controller down, let go of both sticks and check again.
Paired, but the pairing file could not be saved: …
Could not make a key for the sign-in.
The connection to Discord's sign-in closed. Try again.
Discord's sign-in answered in a way this version cannot read.
Discord did not give a code to show.
Discord did not finish the sign-in.
Discord asked for a captcha, which this version cannot show. Try again later.
Discord refused the sign-in (…).
Could not reach Discord to finish the sign-in.
Join a voice channel first, and wait until it says it is accepted.
Go Live works in a server's voice channel for now, not in a call.
Discord did not start the stream.
Join the voice channel first, and wait until it says it is accepted.
That person is not streaming.
Discord did not open the stream.
Discord ended the stream (…).
Discord says this sign-in is no longer valid. Sign in again.
The connection to Discord was lost. Reconnecting.
Discord sent a stream address this version cannot read.
The stream connection ended (code …).
Discord's stream server did not answer the connection request.
The connection to Discord's stream server failed (…).
The phone's WebRTC connection could not start.
The phone's video encoder could not start.
No Steam server could be reached.
Steam's server list could not be loaded
Steam answered … with error ….
failed (Steam sent it encrypted; not supported)
failed (the download did not match Steam's checksum: …; not saved)
StikDebug is not installed. Install it and try again.
Porthole could not open StikDebug. Check that it is installed and open it once yourself, then start the game again.
Porthole has to close and open again before the next game starts. Use Close Porthole on the Home screen, then open it again.
This game is on the SSD, but it starts without Steam's launcher, and only a start through Steam can reach the SSD. Move it to the device (remove it and download it again to the device) to play it.
Porthole cannot find this game's program (…). It may have been moved or deleted. Remove the game from the library and add it again with +.
… is built on Microsoft's .NET Framework, which needs Wine Mono (about 42 MB). Download it, then start the game again.
In-app JIT needs a pairing file. Open Settings › Setup guide to import one, or choose a different JIT method there.
StikDebug is not installed. Install it, or choose a different JIT method in Settings › Setup guide.
JIT was not turned on within five minutes. Try again, or pick a different JIT method in Settings › Setup guide.
Porthole could not set aside the memory the emulator needs. Close Porthole completely (swipe it away), close other apps, open Porthole again and start the game. If it keeps happening, restart the device.
iOS left too little room for this game on this start of Porthole (… MB of the … MB it needs). Close Porthole and open it again, then start the game: it is different each time.
iOS put something in the part of memory this game's program has to load at (it needs … MB there) on this start of Porthole. Close Porthole and open it again, then start the game: it is different each time.
Windows support (the wineserver) did not start. Close Porthole completely and open it again. If it happens again, restart the device: iOS may be short of memory. Then send a report from Settings › Report a problem.
Windows support (the wineserver) stopped while it was starting, so the game was not started. Close Porthole completely and open it again. If it keeps happening and Porthole runs inside another app, that app may not allow the connection Windows support needs; install Porthole on its own, or send a report from Settings › Report a problem.
The game's program could not be started. Close Porthole completely and open it again. If it happens again, send a report from Settings › Report a problem.
End the running program before updating it.
End the running program first.
The files were not saved. Check that the device has free space.
Could not remove Epic files:

Error

The iPhone sent something unreadable (…).
Pairing went off script: ….
The code was wrong. Start again and type the new code.
Can't reach the compatibility server right now.
That file is too big to be a bind set.
That is not a Porthole bind set.
That bind set was made by a newer version of Porthole.
That bind set has nothing in it.
Download the Steam client first.
Close the running game first.
Valve's server did not give the file. Try again.
The file did not match what was expected, so it was not used.
The tunnel extension is missing from this build.
iOS wouldn't start the tunnel. After an app update this usually clears by restarting the device. Restart it and try again; your games and settings are not affected.
The tunnel did not connect. Allow the VPN when iOS asks, and check the tunnel extension is signed with a profile that has the Network Extension (packet tunnel) entitlement.
What was downloaded is not the Microsoft installer this app expects, so it was not used. Try again.
The Microsoft installer could not be unpacked (…).
… does not match Microsoft's original, so it was not used.
Could not read “…”. If the folder is in iCloud Drive, open it in Files and download it first (tap the cloud icon), then try again.
Not enough free space: the game needs … and the phone has … free.
Epic download failed (HTTP …). Try again.
Could not reach itch.io. Check your connection and try again.
itch.io did not accept the API key. Make a new one and sign in again.
The requested path leaves the external folder.
The saved external drive registration is invalid.
The external drive mapping is already in use. Existing files were kept.
This is not the registered folder. Select the original folder.
The external drive is not available. Reconnect it and try again.
Steam's components could not be verified. Try downloading them again.
Existing Steam files need attention. They were kept. Use the desktop setup option.
Close the running session before preparing Steam's components.
Madeira could not prepare its Windows environment.
Reconnect the registered SSD and try again.
Select the registered folder again to renew access.
This is not the registered library folder. Select the original folder.
The library could not be accessed.
The requested path leaves the registered library.
Select a dedicated folder on a locally attached drive. Cloud and network folders are unsupported.
The saved library registration is invalid.
The Windows SSD drive mapping is already in use. The registered library folder is unchanged.
A game or Steam is still running. Close it (Home, then swipe the game away or use Close in the menu), then try again.
That folder is on the device itself (On My iPad or an app's folder), not on an external drive. Open the drive in the picker (it is listed under Locations) and choose a folder on it.
This drive cannot hold files over 4 GB (it is formatted FAT32), and most games have some. Format it as exFAT on a computer, then choose the folder again.
Madeira's JIT script is missing from this installation. Reinstall Madeira.
Madeira could not create the StikDebug request.
StikDebug is not installed. Install it, or configure Built-in StikJIT.
StikDebug did not attach to Madeira within 90 seconds. Check its pairing file and LocalDevVPN, then try again.
Sign in to EA to continue.
EA's server answered with HTTP …. Try again later.
EA's server declined the request: …
EA sent an unexpected answer (…).
EA has no PC build of this game for Porthole to download.
The game's files downloaded, but they do not say which program starts the game (__Installer/installerdata.xml). Add the game with + and choose its .exe.
EA did not give this game a licence (…). Check that your account owns it and try again.
Not enough free space on this device: this download needs about … more. Free some space, then try again.
A game file could not be downloaded from EA (…). Try again to continue.
EA's build names a file outside the game's folder (…).
EA's build file is not a zip Madeira can read (no central directory).
EA's build file could not be read (…).

Plain-language error

<what was being done> failed: <plain reason>
The server did not understand the request (400). Updating Porthole may fix it.
The server did not allow it (…). Signing in again may fix it.
The server does not have what was asked for (404). It may have been moved or removed.
The server took too long to answer (408). Try again in a moment.
Too many requests were sent in a short time (429). Wait a few minutes and try again.
The server is having trouble (…). This is not on your side: try again later.
The server answered with an unexpected status (…). Try again later.
The answer from the server was not in the form this version of Porthole expects. Updating Porthole may fix it; if it does not, send a report from Settings.
There is no internet connection. Check Wi-Fi or mobile data, then try again.
Mobile data is off for Porthole, and there is no Wi-Fi. Turn on Wi-Fi, or allow Porthole to use mobile data in Settings › Cellular, then try again.
The server took too long to answer. Try again in a moment, or on a better connection.
The server's address could not be found. If the internet works for other apps, the server may be down, or a VPN, ad blocker or school or work network may be blocking it. Try again later or on another network.
The server could not be reached. It may be down, or something on your network is blocking it. Try again later or on another network.
The connection dropped part-way. Try again; a steadier connection helps.
A secure connection to the server could not be made. Check that the date and time on this device are right, and that a VPN or a school or work network is not interfering, then try again.
The server gave an answer Porthole could not use. It may be having trouble: try again later.
The server does not have this file any more. It may have been moved or removed.
The address is not one Porthole can use. Check it for typing mistakes.
The server is not using a secure connection, which iOS does not allow here.
iOS stopped the background download. Open Porthole and start it again.
There is not enough free storage on this device. Free some space (Settings › General › iPhone Storage) and try again.
Porthole is not allowed to use that file or folder. If it is in Files or on an external drive, give Porthole access to it again.
A file Porthole needs is not there any more. It may have been moved or deleted: choose it again, or add it again.
A file is damaged or in a form Porthole does not know. If it is a download, download it again.
That place can only be read, not written to. Choose another place.
The name of the file has a character it cannot have. Rename it and try again.
The file is in use by something else. Wait a moment and try again.
The device could not read or write the file. If this repeats, restart the device.
Porthole is not allowed to do that to the file or folder.
A file or folder Porthole needs is not there any more.
That place can only be read, not written to.
The device's storage reported an error while reading or writing. If this repeats, restart the device.
The device ran out of memory. Close other apps and try again.
Too many files are open at once. Close Porthole fully and open it again.
The server refused the connection. It may be down: try again later.
The server took too long to answer. Try again in a moment.
The connection dropped part-way. Try again.
Something went wrong that Porthole has no better words for (…). Try again; if it repeats, send a report from Settings and mention this number.