Install

Update, roll back, remove

Check for a release, switch versions, or remove Open Canvas while keeping your work.

Check for updates

Use these commands in a terminal:

bash
open-canvas update --check
open-canvas changelog --latest

The first checks whether a newer release is available. The second shows the latest release notes. In an open editor file, choose Help → Changelog for the installed version's notes, or print the bundled history in a terminal:

bash
open-canvas changelog

Install an update

Before updating, export a JSON backup. Stop the editor and disconnect installed MCP clients. The updater uses the installer already in the installed bundle (install.ps1 on Windows). It downloads the matching archive, verifies its checksum and version, and changes the launcher to use it only after verification. It does not migrate or delete workspace data, edit agent configuration, or restart a currently running app.

bash
open-canvas update

Roll back

To roll back, reinstall a chosen version with the installer and a release tag that has matching platform assets:

bash
curl -fsSL https://open-canvas.xyz/install.sh | bash -s -- --version vX.Y.Z

On Windows, download install.ps1 as shown in the install guide and pass -Version:

powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\open-canvas-install.ps1 -Version vX.Y.Z

Keep the archive and its checksum if you want an offline rollback. An older release may not open documents saved in a newer format, so keep a backup from before the upgrade.

Remove Open Canvas

Stop the editor and its installed MCP clients, then remove the launcher and installed release files:

bash
rm ~/.local/bin/open-canvas
rm -rf ~/.open-canvas/install

On Windows, stop the editor and its installed MCP clients, then remove %USERPROFILE%\.open-canvas\install and delete its bin entry from your user PATH (Settings, System, About, Advanced system settings, Environment Variables).

Your workspace data lives separately under ~/.open-canvas/data/; keep that directory if you may want the work later. Older data under ~/.open-cavas/data/ remains readable.

Written for Open Canvas 0.8.0