# Bach > Bach builds modern, clean Windows installers. Write one bach.toml, run bach build, and ship a single Setup.exe with a native-looking window, in-place updates and a clean uninstaller. > ## 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. - [Bach: Windows installers from one bach.toml](https://bach.mintlify.dev/docs/index.md): Bach packs your app folder and a short config file into one Setup.exe with a calm native window, in-place updates and a clean uninstaller. - [Everything Bach can do](https://bach.mintlify.dev/docs/features.md): Every Bach feature in one place, grouped by what you want to do: build, shape the window, change Windows, update, deploy and test, with a link to each page. - [Quickstart: build your first Bach installer](https://bach.mintlify.dev/docs/quickstart.md): Install the bach command, write a minimal bach.toml, preview the window and build a Setup.exe for your Windows app in about five minutes. - [Install the bach command on Windows, macOS and Linux](https://bach.mintlify.dev/docs/installation.md): Install bach and its setup runtime with PowerShell, a shell script, Scoop, a release zip, cargo or the GitHub Action, and check the result with bach doctor. - [Why Bach, and when to use something else](https://bach.mintlify.dev/docs/why-bach.md): How Bach compares with NSIS, Inno Setup and WiX, what it covers by design, and the cases where another installer builder is the better choice. - [Prepare your app: build it into one folder](https://bach.mintlify.dev/docs/guides/prepare-your-app.md): Bach installs the contents of one folder. Learn what belongs in it and which build folder to use for Rust, Tauri, Electron, .NET, Go and PyInstaller apps. - [Write your bach.toml with bach init and bach check](https://bach.mintlify.dev/docs/guides/write-bach-toml.md): Create a starter bach.toml with bach init, let Bach detect your stack, and validate every setting and file with bach check before you build. - [Customize the installer window: logo, accent, theme and texts](https://bach.mintlify.dev/docs/guides/customize-the-window.md): Set your logo, accent colour, theme, languages, license page and every text in the Bach installer window, in one language or per language. - [Choices and optional components in the install window](https://bach.mintlify.dev/docs/guides/choices-and-components.md): Decide which shortcuts, PATH and autostart options users see, how true, false, always and never behave, and how to split your app into optional components. - [Windows integration: shortcuts, link schemes and file types](https://bach.mintlify.dev/docs/guides/integration.md): Add extra Start menu shortcuts, register myapp:// link schemes and file types, and know how Bach avoids taking over other programs' associations. - [Check requirements like WebView2 and .NET before installing](https://bach.mintlify.dev/docs/guides/requirements.md): Declare what your app needs on the computer, such as WebView2, a .NET runtime or the Visual C++ redistributable, and let setup check it read-only before installing. - [Preview the window, build the setup file and inspect it](https://bach.mintlify.dev/docs/guides/preview-and-build.md): Use bach preview to see every window without installing, bach build to write the Setup.exe, and bach inspect to see what a setup file carries. - [The uninstaller and your users' data](https://bach.mintlify.dev/docs/guides/uninstall-and-user-data.md): Configure the uninstaller: which data folders it may delete, the opt-in checkbox, the feedback link, and exactly what removal touches and what it keeps. - [Install for every user with one administrator prompt](https://bach.mintlify.dev/docs/guides/machine-wide-installs.md): Install your app for every user of a computer with installer.scope = machine: one Windows prompt, Program Files, HKLM, elevated run steps and what changes. - [Move from Inno Setup, NSIS or an MSI to Bach](https://bach.mintlify.dev/docs/guides/migrate-from-another-installer.md): Move an app from Inno Setup, NSIS or an MSI to Bach: find the old install's Uninstall key, add [[migrate]] and know what setup removes and what it leaves. - [Antivirus warnings on setup files](https://bach.mintlify.dev/docs/guides/antivirus.md): What to do when Microsoft Defender or another antivirus flags a Bach setup file: why it happens, what we saw in testing, signing, reporting and the build machine. - [Release from GitHub with one click](https://bach.mintlify.dev/docs/guides/releasing.md): Add the release workflow with bach init or bach workflow, then press Run workflow: Bach raises every version file, builds, tags and publishes the release. - [Ship updates: from GitHub releases to self-updating apps](https://bach.mintlify.dev/docs/guides/updates.md): Publish updates from GitHub with the Bach action, and let installed apps download them in the background and install them when the app closes, even after a power cut. - [Sign a setup file to reduce SmartScreen warnings](https://bach.mintlify.dev/docs/guides/signing.md): Sign your finished Bach setup file with signtool so SmartScreen trusts it over time. Sign after bach build, verify it, then rewrite the update feed. - [Silent installs and uninstalls for IT tools and scripts](https://bach.mintlify.dev/docs/guides/silent-installs.md): Install and remove Bach setup files without a window using --silent or /S, with --dir, --with, --without, --lang, --log and exit codes for automation. - [Build setup files in CI with the GitHub Action](https://bach.mintlify.dev/docs/guides/ci.md): Build a Bach setup file on any CI runner with the usebach/bach GitHub Action or the install scripts, with inputs, outputs and Windows, macOS and Linux notes. - [List your app in winget with bach winget](https://bach.mintlify.dev/docs/guides/winget.md): Generate the three manifests the Windows Package Manager needs from a Bach setup file, validate them and open a pull request to microsoft/winget-pkgs. - [Windows Installer packages (MSI)](https://bach.mintlify.dev/docs/guides/msi.md): Write a real .msi from the same bach.toml for Group Policy, Configuration Manager and Intune: files, shortcuts, registry values, components and upgrades. - [How Bach works: the setup file, installing and removing](https://bach.mintlify.dev/docs/concepts/how-it-works.md): Learn how a Bach setup file is built from bach-setup.exe plus a payload, what happens during an install, update and removal, and where logs and languages come from. - [The installer window: every page and state](https://bach.mintlify.dev/docs/concepts/installer-window.md): A tour of the Bach setup window: requirement, license, ready, working, done and failed pages, update, reinstall and downgrade states, and keyboard use. - [Safety rules: what Bach promises and how it keeps them](https://bach.mintlify.dev/docs/concepts/safety.md): The promises behind every Bach setup file: paths cannot escape the install folder, data is deleted only on request, administrator rights only on request, no foreign keys. - [Threat model: what Bach trusts and what it does not](https://bach.mintlify.dev/docs/concepts/threat-model.md): Who and what Bach trusts, what it protects, and the known gaps: the feed host, mirrors, staging folder, access keys, build machine and elevated runs. - [bach.toml reference: every setting Bach reads](https://bach.mintlify.dev/docs/reference/config/overview.md): The structure of bach.toml: which sections are required, how errors are reported, and a complete example that uses every section. - [[app]: name, version, publisher and program](https://bach.mintlify.dev/docs/reference/config/app.md): Reference for the [app] section of bach.toml: name, version, publisher, executable, id, description, website and icon, with defaults and rules. - [[files]: choose the folder and leave files out](https://bach.mintlify.dev/docs/reference/config/files.md): Reference for the [files] section of bach.toml: the source folder that gets installed and the exclude patterns that keep build leftovers out. - [[installer]: look, folder, options, languages and license](https://bach.mintlify.dev/docs/reference/config/installer.md): Reference for the [installer] section of bach.toml: output, theme, accent, logo, compression, install folder, the four option values, languages and license. - [[uninstall]: user data and the feedback link](https://bach.mintlify.dev/docs/reference/config/uninstall.md): Reference for [uninstall] in bach.toml: data folders offered for deletion, their description and the feedback_url shown after removing the app. - [[style]: built-in styles, fonts, colours and backgrounds](https://bach.mintlify.dev/docs/reference/config/style.md): Pick one of 14 built-in styles for the Bach installer window with installer.style, then change its fonts, colours, corners, gradient and background picture. - [[layout]: presets, window size, panels, spacing and motion](https://bach.mintlify.dev/docs/reference/config/layout.md): Start from one of ten layouts for the Bach installer window, then set its size, a picture panel or banner, a floating card, tiles, spacing and animation. - [[text]: replace any text the installer window shows](https://bach.mintlify.dev/docs/reference/config/text.md): Reference for [text] in bach.toml: every text name, its English default and its placeholders, for replacing any word in the window, per language. - [[[components]]: optional parts of your app](https://bach.mintlify.dev/docs/reference/config/components.md): Reference for [[components]] in bach.toml: id, title, description, files and default for optional parts the user can leave out of an install. - [[[protocols]] and [[file_types]]: links and files your app opens](https://bach.mintlify.dev/docs/reference/config/protocols-and-file-types.md): Reference for [[protocols]] and [[file_types]] in bach.toml: register a myapp:// link scheme and file extensions for the user, with the refused values. - [[[requirements]]: what the app needs on the computer](https://bach.mintlify.dev/docs/reference/config/requirements.md): Reference for [[requirements]] in bach.toml: webview2, dotnet, vcredist, file, registry and windows kinds, their fields and what setup does when one is missing. - [[[shortcuts]]: more Start menu shortcuts](https://bach.mintlify.dev/docs/reference/config/shortcuts.md): Reference for [[shortcuts]] in bach.toml: add Start menu shortcuts for a second program or for the app started with arguments. - [[[context_menu]]: add right-click entries](https://bach.mintlify.dev/docs/reference/config/context-menu.md): Reference for [[context_menu]] in bach.toml: add Explorer right-click entries for files, folders, a folder's background or one file type that start your app. - [[[run]]: run a program during setup](https://bach.mintlify.dev/docs/reference/config/run.md): Reference for [[run]] in bach.toml: run a packaged program on install, first install or before removal, with exit codes that count as success. - [[[registry]]: write registry values](https://bach.mintlify.dev/docs/reference/config/registry.md): Reference for [[registry]] in bach.toml: write registry values below Software and remove them only while they still hold the value setup wrote. - [[[env]]: set environment variables](https://bach.mintlify.dev/docs/reference/config/env.md): Reference for [[env]] in bach.toml: set user environment variables, with the install folder as {app}, and remove them only while they still hold your value. - [[[services]]: install Windows services](https://bach.mintlify.dev/docs/reference/config/services.md): Reference for [[services]] in bach.toml: install a Windows service with its start type and account, have it stopped during updates and deleted on removal. - [[[firewall]]: add Windows Firewall rules](https://bach.mintlify.dev/docs/reference/config/firewall.md): Reference for [[firewall]] in bach.toml: let an app or some ports through Windows Firewall, for chosen networks, and have the rule removed with the app. - [[[migrate]]: remove an older install](https://bach.mintlify.dev/docs/reference/config/migrate.md): Reference for [[migrate]] in bach.toml: remove an older Inno Setup, NSIS or MSI install of your app before a first install, without ever stopping the install. - [[updates]: let the installed app update itself](https://bach.mintlify.dev/docs/reference/config/updates.md): Reference for [updates] in bach.toml: github or a feed link, download_url and auto, which make bach build write latest.json and let the installed app update itself. - [[access]: ask for a key and encrypt the files](https://bach.mintlify.dev/docs/reference/config/access.md): Reference for [access] in bach.toml: an access key the installer asks for, encrypted packaged files, private updates, and what this does and does not protect. - [[signing]: sign your setup files](https://bach.mintlify.dev/docs/reference/config/signing.md): Reference for [signing] in bach.toml: name the program that signs your setup files. Signing is optional and only runs with bach build --sign or BACH_SIGN=1. - [[profiles]](https://bach.mintlify.dev/docs/reference/config/profiles.md): Build other versions of the same app from one bach.toml: a machine-wide company version, a portable ZIP, each with its own settings and file. - [[arch.arm64]](https://bach.mintlify.dev/docs/reference/config/arch.md): One download for x64 and ARM64: build an ARM64 setup file next to the x64 one and list both in the update feed; the online installer picks the right one. - [The bach command: every command at a glance](https://bach.mintlify.dev/docs/reference/cli/overview.md): Overview of the bach command line: init, check, preview, watch, build, test, diff, verify, feed, sign, winget, choco, intune, version and workflow, with flags. - [bach init: write a starter bach.toml](https://bach.mintlify.dev/docs/reference/cli/init.md): bach init [DIR]: writes a commented bach.toml, filled in from your Rust, Tauri, Electron, .NET, Godot, Unity or other project. It never overwrites a file. - [bach import](https://bach.mintlify.dev/docs/reference/cli/import.md): Write a first bach.toml from an Inno Setup (.iss) or NSIS (.nsi) script, and see what could not be converted, so moving to Bach starts from a real file. - [bach check: validate bach.toml and list the files](https://bach.mintlify.dev/docs/reference/cli/check.md): bach check [CONFIG]: reads a bach.toml, lists every file and option the installer would carry, and reports mistakes and warnings in plain sentences. - [bach build: write the Setup.exe](https://bach.mintlify.dev/docs/reference/cli/build.md): bach build [CONFIG]: packs your files and settings into one setup file. Flags: --out, --fast, --sign to sign it, --patch-from to also write an update patch. - [bach preview: see the installer window without installing](https://bach.mintlify.dev/docs/reference/cli/preview.md): bach preview [CONFIG]: opens the real installer or uninstaller window with every step pretended. Flags: --uninstall, --theme and --lang. Needs Windows. - [bach watch: reopen the preview on every save](https://bach.mintlify.dev/docs/reference/cli/watch.md): bach watch [CONFIG]: keeps the installer preview open and reopens it whenever bach.toml, or a logo, license or text file it names, changes. Needs Windows. - [bach styles: the built-in styles of the installer window](https://bach.mintlify.dev/docs/reference/cli/styles.md): bach styles lists the 14 built-in styles of the installer window for installer.style: what each looks like and what kind of app it suits. Also as --json. - [bach layouts: the built-in layouts of the installer window](https://bach.mintlify.dev/docs/reference/cli/layouts.md): bach layouts lists the ten built-in layouts of the installer window for [layout] preset: what each looks like, what it suits and the picture it shows best. - [bach inspect: see what a setup file carries](https://bach.mintlify.dev/docs/reference/cli/inspect.md): bach inspect FILE: prints what a Bach setup file or an installed uninstall.exe carries, from app id and files to options, languages and update feed. - [bach verify: check a setup file for damage](https://bach.mintlify.dev/docs/reference/cli/verify.md): bach verify FILE: checks a Bach setup file without installing it, against the SHA-256 checksums recorded at build, and says whether it carries a signature. - [bach diff](https://bach.mintlify.dev/docs/reference/cli/diff.md): Compare two setup files of one app: the files added, removed and changed, new registry values and variables, and which files made the app bigger. - [bach test](https://bach.mintlify.dev/docs/reference/cli/test.md): Install a setup file on a clean Windows in Windows Sandbox, start the app, remove it, and get a report of failures and leftover files. - [bach doctor: check that a build will work](https://bach.mintlify.dev/docs/reference/cli/doctor.md): bach doctor [CONFIG]: reports the Bach version, the setup runtime, the config, preview availability and signtool, and says exactly what to fix. - [bach feed: write the update feed for a setup file](https://bach.mintlify.dev/docs/reference/cli/feed.md): bach feed FILE: writes latest.json for a setup file, with its version, download link, size and SHA-256. Run it again after signing. - [bach feed-key: make the key that signs update feeds](https://bach.mintlify.dev/docs/reference/cli/feed-key.md): bach feed-key writes a private key file and prints the public_key line for bach.toml, so installed apps accept only update feeds you signed. - [bach winget: write the winget manifests](https://bach.mintlify.dev/docs/reference/cli/winget.md): bach winget FILE --url URL: writes the three winget manifests for a Bach setup file. Flags: --license for the license and --out for the target folder. - [bach choco: write the Chocolatey package](https://bach.mintlify.dev/docs/reference/cli/choco.md): bach choco FILE --url URL: writes a Chocolatey package for a Bach setup file, with a nuspec and install and uninstall scripts that check the SHA-256 first. - [bach intune: settings for Microsoft Intune](https://bach.mintlify.dev/docs/reference/cli/intune.md): bach intune FILE: writes the install and uninstall commands, the detection rule and a detection script that deploy a Bach setup file with Microsoft Intune. - [bach page: write a download page](https://bach.mintlify.dev/docs/reference/cli/page.md): bach page FILE --url URL: writes a one-file download page for a Bach setup file, with the size, a download button, install steps and the SHA-256 to check. - [bach sign: sign a setup file](https://bach.mintlify.dev/docs/reference/cli/sign.md): bach sign: sign a setup file with the program [signing] in bach.toml names. Optional, and it only runs when you call it or build with --sign. - [bach key: make access keys](https://bach.mintlify.dev/docs/reference/cli/key.md): bach key: prints random access keys for an app with [access], one per line, ready to use as BACH_ACCESS_KEY or to hand to customers. - [bach profiles](https://bach.mintlify.dev/docs/reference/cli/profiles.md): List the profiles of a bach.toml: other builds of the app, like a portable ZIP or a machine-wide company version, and the files they write. - [bach version: show or raise the version everywhere](https://bach.mintlify.dev/docs/reference/cli/version.md): bach version [TARGET]: lists the version in bach.toml, package.json, lock files, Cargo and Tauri files, or raises it in all of them at once. - [bach workflow: add the one-click release workflow](https://bach.mintlify.dev/docs/reference/cli/workflow.md): bach workflow [DIR]: writes .github/workflows/bach-release.yml, a release you start under Actions › Release › Run workflow, filled in for your stack. - [bach update: update bach to the newest release](https://bach.mintlify.dev/docs/reference/cli/update.md): bach update installs the newest Bach release from GitHub, checks its SHA-256 first and keeps the old files if a step fails. Also covers the update notice. - [Setup file command line: every flag a setup or uninstall.exe accepts](https://bach.mintlify.dev/docs/reference/setup/command-line.md): Every flag a Bach setup file and an installed uninstall.exe understand: --silent, --dir, --with, --without, --lang, --log, --allow-downgrade, --update, --download-update, --apply-update and more. - [Exit codes of setup files and the bach command](https://bach.mintlify.dev/docs/reference/setup/exit-codes.md): The exit codes of a silent install, a silent removal, uninstall.exe --check-update and the bach command, so scripts and IT tools can react correctly. - [Environment variables read by Bach and its install scripts](https://bach.mintlify.dev/docs/reference/setup/environment-variables.md): Every environment variable Bach reads: BACH_RUNTIME, BACH_RELEASES, BACH_NO_DOWNLOAD, BACH_NO_UPDATE_CHECK, BACH_UPDATE_FROM, BACH_INSTALL_DIR, BACH_VERSION, BACH_NO_PATH and BACH_PREVIEW_DIR. - [Files, folders and registry keys Bach creates](https://bach.mintlify.dev/docs/reference/setup/files-and-locations.md): Where Bach and its setup files put things: install folder, uninstall.exe, log, temporary files, runtime cache and the HKCU registry keys they use. - [Editor support: the bach.toml JSON schema](https://bach.mintlify.dev/docs/reference/setup/editor-support.md): Get completion and typo checking for bach.toml in VS Code, Zed and JetBrains with the published JSON schema that bach init adds to every new config. - [Troubleshooting Bach: common messages and how to fix them](https://bach.mintlify.dev/docs/resources/troubleshooting.md): Fix the messages people meet most when installing bach, building a setup file or running one: runtime download, missing files, symlinks, locked files and downgrades. - [Bach frequently asked questions](https://bach.mintlify.dev/docs/resources/faq.md): Short answers to common questions about Bach: administrator rights, machine-wide installs, updates, file size, languages, platforms, signing and licensing. - [Use Bach with coding agents: the Bach skill](https://bach.mintlify.dev/docs/resources/agents.md): Install the Bach skill so coding agents like Claude Code and Codex can package a Windows app with bach.toml, and see the rules they follow when using it. - [Benchmarks: Bach, Inno Setup, NSIS and WiX](https://bach.mintlify.dev/docs/resources/benchmarks.md): 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. - [Bach changelog: what changed in each release](https://bach.mintlify.dev/docs/resources/changelog.md): Release notes for every Bach version, newest first: what is new, what was fixed and what was improved in each release from 0.1.0 to 0.9.0. - [Bach security policy: report a vulnerability](https://bach.mintlify.dev/docs/resources/security.md): How to report a security problem in Bach privately, which versions get fixes, and what counts as a vulnerability and what does not. - [Contribute to Bach: bugs, translations, docs and code](https://bach.mintlify.dev/docs/resources/contributing.md): How to help with Bach: report bugs, fix translations, improve these docs or send a pull request, with the checks every change must pass. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.