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

# [profiles]

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

A profile is another build of the same app from the same `bach.toml`. Each profile holds only what differs from the file above it.

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[profiles.enterprise]
description = "For IT departments: machine-wide, no shortcuts."

[profiles.enterprise.installer]
scope = "machine"
desktop_shortcut = false

[profiles.portable]
kind = "zip"
description = "Unzip and run; nothing is installed."

[[profiles.portable.components]]
id = "samples"
title = "Samples"
files = ["samples/**"]
default = true
```

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
bach profiles                       # lists them and the files they write
bach build --profile enterprise     # only that profile
bach build --all-profiles           # the main setup file and every profile
```

| Setting | Meaning |
| - | - |
| `kind` | `"setup"` (default) writes a setup file. `"zip"` writes a ZIP of the files: no runtime is needed, nothing is signed or listed in the update feed. |
| `description` | One line about the profile; `bach profiles` shows it. |
| `output` | Where the file goes, with `{name}`, `{version}` and `{id}` filled in. Default: `dist/{name}-NAME-Setup-{version}.exe` or `dist/{name}-NAME-{version}.zip`. |

Anything else in a profile is a section of `bach.toml`, laid over the main file. A table is merged key by key; an array (like `[[components]]`) is replaced as a whole. A profile can't change `config_version` or contain profiles. A profile's name is lowercase letters, digits and `-`, up to 32 characters.

* A **ZIP** holds the files of the components ticked by default, with a fixed date on every entry, so the same files give the same ZIP. It can't be locked with `[access]` and has no window to preview.
* A **setup profile** shares `app.id` with the main build unless it sets another. Give a profile that must live next to the main build its own `app.id` and `installer.folder`. Profile builds never write the update feed.
* With `--msi`, a setup profile also writes its own [MSI](/docs/guides/msi.md).


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