Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 14 additions & 1 deletion docs/Troubleshooting/Scanning-Issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,21 @@ When scanning the folders mounted in `/library/roms`, the scanner tries to match

### Scan times out after ~4 hours

The background scan task times out after 4 hours, which can happen if you have a very large library. The easiest work around is to keep running scans every 4 hours, **without** checking the "Complete re-scan" option.
The background scan task times out after 4 hours, which can happen if you have a very large library. The easiest work around is to keep running scans every 4 hours, **without** checking the "Complete re-scan" option. You can also change the timeout via [environment variable](../Getting-Started/Environment-Variables.md) `SCAN_TIMEOUT`.

### Scan stops before finishing a platform

Check the logs for RomM, you should find a line that looks like `ERROR: [RomM][scan_handler][2025-04-12 11:48:55]` that explains why the scanner stopped. This can often happen due to a corrupted file or a file the [python zipfile library](https://docs.python.org/3/library/zipfile.html) cannot handle, such as old DOS zip files with backslashes instead of forward slashes.

### When scanning a very large library with many platforms it is difficult to keep track of which systems have scanned in

The easiest method is to check the logs via this command, which will list all the scanned platforms since the RomM container was started `docker logs romm 2>/dev/null|egrep 'scan_handler.*Identified as.*🎮'`

Here is an example output:

```text
$ docker logs romm 2>/dev/null|egrep 'scan_handler.*Identified as.*🎮'
INFO: [RomM][scan_handler][2025-04-12 11:37:40] Identified as PlayStation 🎮
INFO: [RomM][scan_handler][2025-04-12 14:39:32] Identified as DOS 🎮
INFO: [RomM][scan_handler][2025-04-13 12:50:42] Identified as WonderSwan 🎮
```