site/start/install.md

# Install Tolaria

Tolaria publishes desktop builds for macOS, Windows, and Linux. macOS is the primary day-to-day development target, with Windows and Linux builds supported through the release pipeline and fixed as platform issues are found.

## Download

Use the latest stable release unless you are intentionally testing pre-release builds:

- <a href="https://tolaria.md/download/" target="_self">Download the latest stable build</a>
- [Browse all GitHub releases](https://github.com/refactoringhq/tolaria/releases)
- <a href="https://tolaria.md/releases/" target="_self">Read the release notes</a>

## Homebrew

On macOS you can install the cask:

```bash
brew install --cask tolaria
```

## Platform Status

| Platform | Status | Notes |
| --- | --- | --- |
| macOS | Primary | Apple Silicon and Intel builds are published. Homebrew is available. |
| Windows | Supported, early | NSIS installers are Authenticode-signed and updater bundles are Tauri-signed. Company-managed SmartScreen, Defender, or WDAC policies can still require IT approval of the Tolaria publisher before first install. |
| Linux | Supported, early | AppImage, deb, and RPM artifacts are published. Desktop behavior depends on distribution WebKitGTK and input-method integration. |

See [Supported Platforms](/reference/supported-platforms) for the current support policy.

## Managed Windows Devices

Do not disable SmartScreen or Windows Security to install Tolaria. On a managed Windows device, validate that the downloaded installer has a valid Tolaria Authenticode signature, then install it through the normal Windows prompt. If company policy still blocks the first run because reputation is not yet established, ask IT to approve the Tolaria publisher or deploy the same signed installer through the approved software portal.

## After Installing

1. Open Tolaria.
2. Choose the Getting Started vault if you want a guided sample.
3. Or open an existing folder of Markdown files as a vault.
4. Use the command palette with `Cmd+K` on macOS or `Ctrl+K` on Linux and Windows.
feat: bundle docs for Tolaria agents 2026-05-06 22:57:06 +02:00			`# Install Tolaria`

			`Tolaria publishes desktop builds for macOS, Windows, and Linux. macOS is the primary day-to-day development target, with Windows and Linux builds supported through the release pipeline and fixed as platform issues are found.`

			`## Download`

			`Use the latest stable release unless you are intentionally testing pre-release builds:`

fix: use canonical download URL 2026-05-07 13:02:51 +02:00			`- <a href="https://tolaria.md/download/" target="_self">Download the latest stable build</a>`
feat: bundle docs for Tolaria agents 2026-05-06 22:57:06 +02:00			`- [Browse all GitHub releases](https://github.com/refactoringhq/tolaria/releases)`
fix: restore generated release history page 2026-05-07 14:59:11 +02:00			`- <a href="https://tolaria.md/releases/" target="_self">Read the release notes</a>`
feat: bundle docs for Tolaria agents 2026-05-06 22:57:06 +02:00
			`## Homebrew`

			`On macOS you can install the cask:`

			```bash
			`brew install --cask tolaria`
			```

			`## Platform Status`

			`\| Platform \| Status \| Notes \|`
			`\| --- \| --- \| --- \|`
			`\| macOS \| Primary \| Apple Silicon and Intel builds are published. Homebrew is available. \|`
fix: sign Windows release installers 2026-05-27 15:27:34 +02:00			`\| Windows \| Supported, early \| NSIS installers are Authenticode-signed and updater bundles are Tauri-signed. Company-managed SmartScreen, Defender, or WDAC policies can still require IT approval of the Tolaria publisher before first install. \|`
feat: expose rpm download option 2026-05-16 13:44:11 +02:00			`\| Linux \| Supported, early \| AppImage, deb, and RPM artifacts are published. Desktop behavior depends on distribution WebKitGTK and input-method integration. \|`
feat: bundle docs for Tolaria agents 2026-05-06 22:57:06 +02:00
			`See [Supported Platforms](/reference/supported-platforms) for the current support policy.`

fix: sign Windows release installers 2026-05-27 15:27:34 +02:00			`## Managed Windows Devices`

			`Do not disable SmartScreen or Windows Security to install Tolaria. On a managed Windows device, validate that the downloaded installer has a valid Tolaria Authenticode signature, then install it through the normal Windows prompt. If company policy still blocks the first run because reputation is not yet established, ask IT to approve the Tolaria publisher or deploy the same signed installer through the approved software portal.`

feat: bundle docs for Tolaria agents 2026-05-06 22:57:06 +02:00			`## After Installing`

			`1. Open Tolaria.`
			`2. Choose the Getting Started vault if you want a guided sample.`
			`3. Or open an existing folder of Markdown files as a vault.`
			4. Use the command palette with `Cmd+K` on macOS or `Ctrl+K` on Linux and Windows.