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

# Windows apps

> Run Windows-only desktop software in a sandbox with Wine, let an agent drive it, and reuse the set-up sandbox as a saved snapshot.

A sandbox runs Windows programs on its Linux desktop through [Wine](https://www.winehq.org).

* The programs open as normal windows on the [desktop stream](https://docs.boat.dev/desktop-streaming). You can watch them.
* The agents of the sandbox can click, type and read them with the built-in [`computer` tools](https://docs.boat.dev/integrated-agents/computer-use).
* You install once. Then you save the sandbox as a [saved snapshot](https://docs.boat.dev/snapshots/templates.md) and start new sandboxes from it.

## Main task

1. [Install Wine](https://docs.boat.dev/windows-apps/install-wine.md) in the sandbox. It takes about 5 minutes.
2. [Install and start the app](https://docs.boat.dev/windows-apps/run-apps.md). Every GUI command needs `DISPLAY=:0`. Check the [tested apps](https://docs.boat.dev/windows-apps/tested-apps.md) first.
3. [Give a prompt to an agent](https://docs.boat.dev/windows-apps/agents-and-forks.md#let-an-agent-drive-it) that uses the app.
4. [Save a saved snapshot and start a sandbox from it](https://docs.boat.dev/windows-apps/agents-and-forks.md#set-up-once-start-many-times) for each task.

If something fails, read [Windows apps troubleshooting](https://docs.boat.dev/windows-apps/troubleshooting.md).

## Learn more

> [card] [Tested apps](https://docs.boat.dev/windows-apps/tested-apps.md)
>
> The apps that run, the extra steps they need, and the apps that do not run.

> [card] [Install Wine](https://docs.boat.dev/windows-apps/install-wine.md)
>
> The install script, and what each part of it does.

> [card] [Run an app](https://docs.boat.dev/windows-apps/run-apps.md)
>
> Install and start an app. Recipes for Steam, Paint.NET, Sysinternals and Direct3D games.

> [card] [Agents and forks](https://docs.boat.dev/windows-apps/agents-and-forks.md)
>
> Let an agent drive the app. Set up once, then start many sandboxes from a saved snapshot.

> [card] [Windows apps troubleshooting](https://docs.boat.dev/windows-apps/troubleshooting.md)
>
> Common errors and their fixes. Licence rules.

## Related

* [Desktop streaming](https://docs.boat.dev/desktop-streaming)
* [Computer use](https://docs.boat.dev/integrated-agents/computer-use.md)
* [Saved snapshots](https://docs.boat.dev/snapshots/templates.md)
* [Long-running tasks](https://docs.boat.dev/long-running-tasks.md)


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