# Installing and upgrading the offline Workflow Editor

You can run the Bitrise Workflow Editor offline, on your own computer, without logging in to [bitrise.io](https://www.bitrise.io/). The Workflow Editor is open source: check out the [bitrise-workflow-editor repository](https://github.com/bitrise-io/bitrise-workflow-editor) on GitHub.

## About the offline Workflow Editor

The offline Workflow Editor is a local copy of the Workflow Editor that ships with the Bitrise CLI. It runs in your browser on your own computer and edits your project's configuration YAML file locally.

Use it when:

- You want to edit your configuration without logging in to bitrise.io.
- Your security policy requires that your configuration never leaves your own network.
- You prefer editing the configuration YAML file in a GUI instead of editing it by hand.

## Limitations

The offline Workflow Editor supports most features of the Workflow Editor on bitrise.io, including Step bundles, containers, and target-based triggers.

One exception: you can't select a stack or machine type, because the **Stacks & Machines** page isn't available locally. You can still set the stack by editing the configuration YAML file directly, but the offline Workflow Editor doesn't validate the stack value: the list of available stacks depends on your account, and the offline Workflow Editor doesn't log in to bitrise.io. To check that a stack value is valid for your project, open **Stacks & Machines** in the Workflow Editor on bitrise.io.

Full feature support requires Bitrise CLI 2.43.0 or newer. On an older version, update the CLI or update the Workflow Editor plugin:

```bash
bitrise plugin update workflow-editor
```

## Installing the offline Workflow Editor to your computer

1. [Install the Bitrise CLI](/bitrise-ci/bitrise-cli/installing-and-updating-the-bitrise-cli).
1. Run `bitrise local setup` to install offline Workflow Editor as part of the Bitrise Plugins.

   Running `bitrise local setup` also checks if Bitrise Core tools, Bitrise Plugins and Toolkits are installed on your local machine. If not, it will automatically install them. On macOS, it also checks for Homebrew, prompting you to install it manually if missing.

## Starting the offline Workflow Editor

1. `cd` into a directory where you have your `bitrise.yml`.
1. Run `bitrise :workflow-editor` command to start your offline session.

   The offline Workflow Editor opens in your browser:

   ![The offline Workflow Editor with the Workflows tab open, showing a Workflow's Steps](/img/bitrise-cli/2026-09-02-offline-workflow-editor.png)

## Upgrading Workflow Editor version

You can upgrade to the latest version of the Workflow Editor by running `bitrise plugin update workflow-editor` command.