> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Bach builds Windows installers from one bach.toml with the bach command: bach init, bach check, bach preview, bach build. Installs are per user and need no administrator rights by default. installer.scope = "machine" installs for every user after one Windows prompt. On Windows, run setup files with Start-Process -Wait -PassThru in PowerShell, and give signtool arguments that start with the word sign.

# Benchmarks: Bach, Inno Setup, NSIS and WiX

> Bach compared with Inno Setup, NSIS and WiX on one real 355 MB Electron app: build, install, update and remove times, plus what happens when things go wrong.

This page compares Bach with Inno Setup, NSIS and WiX (MSI) on one real app, and says what the numbers do and do not show. The scripts and raw results are in the [`bench` folder](https://github.com/usebach/bach/tree/main/bench) of the repository, so you can run them on your own computer.

> [!NOTE]
>
> One computer (Intel Core i5-12400F, 15.7 GB of RAM, SSD, Windows 11 Home, Windows Defender on), one app, one run per setting. Treat the differences as a direction, not as exact figures.

## The app

A real Electron application: the Electron 33.2.0 runtime plus the production `node_modules` of seven well-known packages. It has 10,107 files and weighs 355 MB. A second version (1.1.0) changes about 300 files, adds 60 and removes 40, so an update has real work to do.

Every tool installs per user, silently, without administrator rights. The scripts are the plain ones a developer would write in an afternoon: default settings, no custom pages.

## Speed

| | Bach | Inno Setup | NSIS | WiX (MSI) |
| - | -: | -: | -: | -: |
| Install (median of 3) | 18.2 s | 20.8 s | **13.7 s** | 20.8 s |
| Update 1.0.0 to 1.1.0 | **2.4 s** | 24.1 s | 12.5 s | 135.9 s |
| Remove | 6.8 s | **2.4 s** | 2.8 s | 33.3 s |

A first install is close to a tie: writing 10,000 files dominates, and NSIS was fastest. Updating is where Bach is far ahead, because setup skips files that already match the new version. The Inno and NSIS scripts here copy every file again.

## Build time and size

| Tool | Default build | Heaviest compression |
| - | - | - |
| Bach | 106.9 MB, 121 s | 134.4 MB with `--fast`, 2.8 s |
| Inno Setup | 99.6 MB, 69 s | 87.9 MB, 97 s |
| NSIS | 129.9 MB, 35 s | 90 MB, 136 s |
| WiX (MSI) | 110.4 MB, 58 s | 102.8 MB, 82 s |

Bach's default build is the slowest to make and is not the smallest. Inno Setup and NSIS with their heaviest settings produce smaller files than anything Bach builds today. On a tiny app Bach adds about 9.4 MB for the window's runtime; Inno Setup adds 1.9 MB, NSIS and MSI add nothing measurable.

## When things go wrong

| | Bach | Inno Setup | NSIS | WiX (MSI) |
| - | - | - | - | - |
| A file is locked during an update | Old version intact | Mix of old and new files | Mix of old and new files, exit code 0 | Old version intact |
| One flipped byte in the installer | Refused, nothing written | Refused, nothing written | Refused, nothing written | Refused, nothing written |
| Killed half way, then run again | Correct | A stray temporary file and a second uninstaller | Correct | Not tested |
| User files in the install folder after removal | Kept | Kept | Deleted | Kept |
| Old files after an update | Removed | 40 left | 40 left | Removed |
| Left in the profile after removal | Nothing | Nothing | Nothing | Nothing |

The Inno Setup and NSIS rows describe the plain scripts. A careful script author can add `[InstallDelete]` or explicit `Delete` lines and avoid deleting user files. The comparison shows what each tool does by default, not what is possible.

The MSI keeps the old version intact through Windows Installer's rollback. The price is a 136-second update and a 33-second removal.

## What this does not show

* Another app (many small files, or a few huge ones) moves the numbers.
* Features were not scored. Inno Setup and NSIS have far more scripting power than Bach, and an MSI is what many IT departments deploy with Group Policy or Intune. Bach has one config file, a built-in updater and a modern window. Choose by what you need.
* Bach's figures come from this repository's release build on the day of the run and will change as it does.

To reproduce the run, see [`bench/README.md`](https://github.com/usebach/bach/blob/main/bench/README.md). For moving an existing installer over, see [Migrate from another installer](/docs/guides/migrate-from-another-installer.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.