Measured results

Simulator cost

How long a simulator session takes to start and how much memory it uses, measured with a script you can run yourself.

Edit on GitHub

This page is for developers and self-hosters who want to know what one simulator session costs. You will measure how long a session takes to start and how much memory it uses, then compare with the numbers measured in this repo. All numbers come from scripts/sim-bench/run.mjs.

Run it

  1. Build the sample app for the web:

    bash
    cd apps/tide-and-tackle && PN_SIM=1 npx expo export --platform web --output-dir sim-dist && cd ../..
  2. Run the bench:

    bash
    node scripts/sim-bench/run.mjs --sessions 5 --out .shipvo/sim-bench.json
  3. Read the table it prints, or open .shipvo/sim-bench.json.

Options: --sessions (whole number, 1 or more; default 5), --out (JSON file; default .shipvo/sim-bench.json) and --port (default 4749).

The script starts @shipvo/sim for the sample app, waits for Chromium to launch, then opens sessions one after another and keeps them open.

  • Session start: time from the /session request to the response that holds the first screen, in ms.
  • Memory: resident memory (RSS, MB) of the sim process plus all its child processes (Chromium), read from /proc after 1, 3 and 5 open sessions. On other systems it prints n/a.
  • RSS counts shared pages once for each process, so the total is an upper bound on real use.

Result

Measured on 2026-11-05, 5 sessions, sample app apps/tide-and-tackle (local web build), Chrome Headless Shell 153.

MachineValue
RunnerGitHub Actions Linux, run 42030598917 (the agent job that wrote this page)
CPU4 × AMD EPYC 7763
RAM15.6 GB
Nodev22.23.4
MetricValue
Session start, median1204 ms
Session start, max1235 ms
Session start, all five1235, 1213, 1200, 1202, 1204 ms
Open sessionsRSS (sim + Chromium)
0 (idle, Chromium running)435.6 MB
1599.8 MB
3873.9 MB
51142.1 MB

From the table, each extra session added about 135 MB on this run (1142.1 − 599.8, over 4 sessions: 135.6 MB).

These numbers are from one run of the sample app, on the machine above. For measurements at higher session counts, see Simulator scale results.

Troubleshooting

You seeWhyFix
No web build found. Run: cd apps/tide-and-tackle && PN_SIM=1 npx expo export ...sim-dist/index.html does not exist yet.Run step 1.
--sessions must be a whole number, 1 or moreThe value is zero, negative or not a number.Pass --sessions 5.
Memory shows n/aThe script reads /proc, which only Linux has.Run it on Linux, or use the session start times.

Next steps