> ## 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.

# Bach: Windows installers from one bach.toml

> 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.

Bach builds modern, clean Windows installers. You write one small `bach.toml`, run `bach build`, and get a single `Setup.exe`. Your users see one calm window in their own language. You get updates over older installs and an uninstaller in **Settings › Apps**, without writing any installer logic.

![Bach's install window in light mode, in English: install location, a sample-notes component, desktop shortcut and start-with-Windows options, Cancel and Install buttons](https://mintcdn.com/bach/Nejvqm3NCmw8u8dx/images/install-light.png?fit=max\&auto=format\&n=Nejvqm3NCmw8u8dx\&q=85\&s=cd71edab53dfda9f6780fd902884e2b2)

The install window in light and dark mode.

## The whole workflow

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
bach init      # writes a commented bach.toml
bach check     # validates it and lists every file the installer will carry
bach preview   # opens the real window; nothing is installed
bach build     # writes the setup file
```

A complete config for a Rust app is six lines of settings:

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[app]
name = "Hello"
version = "1.0.0"
publisher = "Hello Inc."
executable = "hello.exe"

[files]
source = "target/release"
exclude = ["*.pdb", "deps/**", "build/**"]
```

```console theme={"theme":{"light":"github-light","dark":"github-dark"}}
$ bach build
Wrote dist\Hello-Setup-1.0.0.exe (9.7 MB)
  Packed       101.8 KB of 216.5 KB (47%), in 0.9s
```

## Start here

> [card] [Quickstart](/docs/quickstart.md)
>
> Go from an app on your disk to a Setup.exe in about five minutes.

> [card] [Install Bach](/docs/installation.md)
>
> PowerShell, macOS and Linux, Scoop, a zip file or the GitHub Action.

> [card] [All features](/docs/features.md)
>
> Everything Bach can do on one page, grouped by what you want to achieve.

> [card] [Why Bach](/docs/why-bach.md)
>
> What Bach does differently, and when to use something else.

> [card] [bach.toml reference](/docs/reference/config/overview.md)
>
> Every setting Bach reads, with defaults and examples.

## What you get

> [card] No script language
>
> Everything is a setting in one TOML file with an editor schema. Every mistake is reported as one sentence naming the setting at fault.

> [card] No administrator prompt by default
>
> Apps install per user into `%LOCALAPPDATA%\Programs` and only write to the user's own folders and `HKCU`. For every user of a computer, `scope = "machine"` installs into Program Files after one Windows prompt.

> [card] Updates that cannot half-fail
>
> A newer setup file updates an install in place. Files are unpacked first and swapped in together; if one is locked, everything is put back.

> [card] A window people can read
>
> 19 languages built in, following the Windows display language, with light and dark mode and every text replaceable.

> [card] Builds anywhere
>
> The `bach` command runs on Windows, macOS and Linux, so installers can come out of any CI. Setup files need no .NET and no Visual C++ runtime.

> [card] Safe by construction
>
> Packaged paths cannot leave the install folder, and the uninstaller removes only what it installed.

## What setup files can do

A short overview. [All features](/docs/features.md) has the full list with a link to each page.

| Area | Capabilities |
| - | - |
| Choices | Desktop and Start menu shortcuts, start with Windows, add to `PATH`, each offered ticked, unticked, always or never. Optional components. |
| Integration | `myapp://` link schemes, file types and right-click entries, never taking over another app's. Windows services and firewall rules for machine-wide installs. |
| Look and words | 14 built-in styles and 10 layouts, or your own fonts, colours, pictures, logo and icon. Light, dark or system theme. Any text, per language. A license page. |
| Safety | Free-space check, archive checksum, one setup per app at a time, "close and continue" when the app is open, data deleted only on request. |
| Automation | `Setup.exe /S` with `--dir`, `--with`, `--without`, `--log`. Quiet uninstall from Settings › Apps. |
| Updates | Over older installs always. In the background from GitHub releases or any https feed, installed when the app is closed, and undone cleanly if a power cut interrupts them. Patches carry only what changed. |
| Deployment | An online installer, access keys, an ARM64 build, profiles such as a portable ZIP, a Windows Installer package (`.msi`), and winget, Chocolatey and Intune output. |

## How these docs are organized

> [card] [Guides](/docs/guides/prepare-your-app.md)
>
> Task-focused walkthroughs: prepare your app, write the config, customize the window, ship updates, sign and automate.

> [card] [Reference](/docs/reference/config/overview.md)
>
> Every `bach.toml` setting, every `bach` command and every flag a setup file understands.

> [card] [Resources](/docs/resources/troubleshooting.md)
>
> Troubleshooting, FAQ, changelog, security policy and how to contribute.

Bach is open source under the MIT license. The code lives at [github.com/usebach/bach](https://github.com/usebach/bach).


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