Skip to content

Troubleshooting

Emu68 Hatcher (host)

Build failures write buildlog.txt next to the .img file. Direct-to-SD builds put it in the cache folder of the Hatcher data folder (see Own packages for where that is); the build dialog's log shows the full path. Please attach it to bug reports. The app itself writes hatcher.log into the Hatcher data folder and keeps the previous run as hatcher.log.1; when the app closes on its own or a tool download fails, attach that file as well.

macOS: build fails with "Operation not permitted" on /dev/disk*

Emu68 Hatcher needs Full Disk Access. Enable it, quit and reopen the app. See Installation → macOS.

Corrupted downloads or tools

Reset App Data… deletes downloaded tools, packages and temporary files. Saved configs stay.

Update or package-list check failed

The app keeps working with the last package list it has. Try Check now again. This can also fix package 404 or checksum errors.

If an app update will not open, use Open Downloads Folder. Linux installation is only offered for Debian-based systems.

Build asks about changed downloads

An optional package whose download no longer matches its checksum is listed in a Changed downloads dialog. Usually the author published a new version under the same file name. Skip them builds without those packages; Install anyway uses the new files, although the install rules were not checked against them. Required packages are never installed from a changed download; that build stops with an error until the package list is updated.

Required ADF or icon set is missing

Disks are matched by content, not filename. Show details... lists missing media; GlowIcons needs its matching ADF.

AmigaOS / Workbench

Network → Network Settings and the Network Settings icon in SYS:Utilities open the Hatcher Prefs window (C:Hatcher-Prefs). Connect, disconnect and the settings are all in that window. The old ARexx scripts stay in S: for the Shell:

rx S:NetworkConfig.rexx                    ; Roadshow settings
rx S:NetworkConfig.rexx ONLINE WIFI        ; or ONLINE ETHERNET
rx S:MiamiNetwork.rexx CONFIG              ; MiamiDX settings
rx S:MiamiNetwork.rexx ONLINE GENET        ; or ONLINE WIFIPI, OFFLINE

Clock is not set after boot (full Roadshow)

With the full Roadshow archive, User-Startup syncs the clock after the network comes up with rx S:NetworkConfig.rexx SYNCTIME, as in earlier releases. Check that Connect at boot is on in Network Settings (it removes S:Network-disabled) and that the network connects at boot.

Browser reports a DNS error

Open Network Settings and check the address, gateway and DNS servers. Save and connect again. Static address, netmask and gateway have to match.

Issue tracker: https://github.com/rootrootde/emu68-hatcher/issues