Troubleshooting

The progress line at the top of the page, next to "Vetro", always says what the machine is doing, and shows errors. The console, under Tools, shows the system's own log; the full setup form (app/?advanced=1) also shows a detailed status line. Start from those.

Browser support

BrowserStatus
Google Chrome, desktopsupported
Microsoft Edge, desktopsupported
Other Chromium-based browsers (Brave, Opera, Vivaldi)usually work; not tested
Firefoxnot supported yet
Safari, and any browser on iPhone or iPadnot supported
Browsers on Android phones and tabletsnot supported

Use a recent version: Vetro needs WebAssembly with SIMD, Web Workers and the Origin Private File System, all present in current Chrome and Edge. When something is missing the page shows a notice above the screen: This browser cannot run Vetro (the phone is not started) or This browser may not run Vetro well (another browser, a phone or tablet, or less memory than the phone needs: the phone starts anyway).

Private (incognito) windows are not recommended: browsers give them much less storage, which may not fit the saved phone, and they forget everything when closed, so every visit downloads the ready-made snapshot again.

Memory

The phone has 2 GiB of RAM of its own (1.5 GiB with the Small phone profile), and the tab needs close to 3 GiB in total while it runs.

Storage

The saved phone takes about 1 GB, and the disk pieces grow as you use it.

The first start is slow, or stops

The phone is slow

Vetro emulates an ARM processor instruction by instruction, in WebAssembly; it is much slower than a real phone, and a single emulated processor does all the work.

The screen stays black

Keys or clicks do nothing

Installing an APK fails

The error from the installer is shown under the drop box. The usual ones:

Clearing data

Reporting a problem

Open an issue on GitHub with the browser and its version, your computer's memory, the device profile, the text of the progress line (and of the notice, if there is one), and the last lines of the console.