Skip to content
DeLFuS77 edited this page Nov 12, 2026 · 2 revisions

Questions and problems

NXDock is a beta: if something here does not help, report the problem.

NXDock does not find my library app

  • Turn on Install over the network in the Settings of Switch Library Manager Web (2.0.5 or newer).
  • The console and the app must be on the same network. A firewall on the computer may block it: allow the app.
  • An app outside your home network, or behind a proxy, can be typed by hand: Settings › Address by hand.

Installs are slow

  • Open NXDock with the full memory of a game: from its HOME menu shortcut (Settings › HOME menu), or by holding R while opening a game. From the Album it has smaller buffers.
  • Run the speed test in Settings: it finds how many connections at once work best on your network.
  • A 5 GHz Wi-Fi or a wired adapter helps more than anything else. A slow or fake SD card slows the write stage: check it in More › Space and dumps › Check the SD card.

An install failed

The queue and the history say what happened and what to do, with a code. Nothing is left half installed. If you report it, see Reporting a problem.

The console went off in the middle of an install

Open NXDock again: it offers to go on where it stopped, keeping the parts already written and checked, or to discard them.

A game installs but does not start

  • Most of your own copies need sigpatches to start, as with any installer. NXDock never installs them.
  • The game may need a newer firmware than the console has: its page says which. Installed › In the console shows the details of each part, with the keys and firmware it needs.
  • If the console asks for an update the game does not have, Installed › In the console can drop the version the console asks for.

Does NXDock need my keys?

Installing does not: NXDock never reads your prod.keys to install. Only Compress games reads them, keeps them in memory and never shows or saves them.

Is it safe to use online?

Installing homebrew and your own copies always carries a risk if the console connects to Nintendo. Use an emuMMC and 90DNS (or a DNS block); NXDock warns before the first install when it finds neither.

How do I update NXDock?

NXDock tells when a new version is out (Settings › Say at start when a new version is out) and installs it from Settings › Look for a new version, after checking its signature. The version before is kept, and Settings › Go back to the version before puts it back. You can also put the new NXDock.nro in place of the old one by hand.

The HOME menu shortcut does not open

The shortcut needs sigpatches, like any homebrew shortcut. If NXDock.nro moved, make the shortcut again from Settings › HOME menu: it is updated.

Can I install official updates over a game compressed by NXDock?

Over a game compressed on its own, an official update installs as usual. Over a merged game, no: install updates with NXDock, which merges them. See Compress games.

Where does NXDock keep its files?

Path What
sdmc:/switch/NXDock/NXDock.nro NXDock itself.
sdmc:/config/NXDock/ Settings, the link to the library app and the shops.
sdmc:/switch/NXDock/history.tsv The history of installs.
sdmc:/switch/NXDock/covers/ The covers, kept after the first time.
sdmc:/switch/NXDock/catalog-cache.json The last list of the library, shown at once on start.
sdmc:/switch/NXDock/mods/ Mod packages, by title ID.
sdmc:/switch/NXDock/resume/ What an install cut by the console going off left, to go on.
sdmc:/switch/NXDock/compressed.txt, recipes/ What Compress games did.
sdmc:/switch/NXDock/*.log install.log, link.log and compress.log, for problem reports.

Deleting sdmc:/config/NXDock/ starts again from the wizard.