PortMaster offline setup
PortMaster games and handheld Linux guide · Updated October 2026
PortMaster can be prepared for offline use by downloading installers, necessary runtimes and supported port packages on another device, then copying them to the correct folders on the handheld storage card.
Plan what must be available offline
Without Wi-Fi on the handheld, you cannot rely on the application fetching packages on demand. Prepare the PortMaster installer, any runtime dependencies and each chosen port in advance.
Use the correct firmware directory
Consult the official installation instructions for the installed firmware. Some systems scan an autoinstall folder for port ZIP files; others need the installer script in a specific Ports or Tools directory.
Avoid damaging the card layout
Use a safe-eject procedure and avoid creating extra directory levels when transferring archives. Windows can prepare SD-card files, but the target firmware runs Linux scripts and may require case-sensitive paths.
Test with a small port first
Choose a ready-to-run port with modest storage requirements. If it launches offline, verify the controller mapping and game saves, then add more demanding games.
Keep a recovery path
Back up working configs and saves before replacing runtimes. An offline installation is easiest to troubleshoot when you retain the installer version and package files used for a known-working setup.
Common questions
Is internet required every time I launch a port?
Not necessarily. Many ports can run offline after they have been installed with all required files and dependencies.
Does the full installer include commercial games?
No. A full installer refers to PortMaster and runtimes, not licensed game assets for Files Needed entries.
Next steps and references
The right setup depends on your firmware and the individual game port. Verify the current compatibility notes before copying files, changing permissions or replacing runtimes.