Skip to content

Install the desktop app

The Upstratus desktop app sets up a supported board over USB. It installs the board's tools, builds the firmware and flashes it, so you never run a toolchain command yourself. It signs in to your account through your browser.

Download it from the Desktop app page (/download/), linked at the top of every page. The page lists the installers built for the site you are on, and puts the one for your computer first.

Platform Installer Board setup
Ubuntu, Debian and derivatives (64-bit) .deb Yes
Other 64-bit Linux .AppImage Yes, on distributions that use apt
Windows 10 and 11 (64-bit) -setup.exe (preview) Not yet
macOS No installer yet Not yet

Windows is a preview

The Windows app installs, opens and signs in. Setting up a board uses Linux package tools today, so on Windows the app cannot install a board's toolchain or flash it yet.

Check your download

Each installer on the download page shows its SHA-256. Compare it with the file you downloaded before you install:

On Linux:

sha256sum upstratus_*_amd64.deb

On Windows, in PowerShell:

Get-FileHash .\upstratus_*_x64-setup.exe -Algorithm SHA256

If the two values differ, delete the file and download it again.

Linux

Ubuntu or Debian: the .deb

sudo apt install ./upstratus_*_amd64.deb

apt installs the libraries the app needs. Open upstratus from your applications menu.

Any other distribution: the AppImage

chmod +x upstratus_*_amd64.AppImage
./upstratus_*_amd64.AppImage

An AppImage needs FUSE 2. On Ubuntu 24.04 install it with sudo apt install libfuse2t64; on older releases the package is libfuse2.

Let the app reach your board

Boards appear as serial ports, which on most distributions belong to the dialout group. Add yourself once, then sign out and back in:

sudo usermod -aG dialout "$USER"

When a board needs a tool that is not installed, the app installs it with apt. If your account cannot run sudo without a password, the app shows the exact command to run instead.

Some boards need a one-time step before your computer can reach them, and some need a button held while you plug them in. The board picker shows this for each board; see Supported boards.

Windows

  1. Run upstratus_*_x64-setup.exe.
  2. The installer is not code-signed yet, so Windows SmartScreen says Windows protected your PC. Choose More info, check the file name, then choose Run anyway.
  3. If Microsoft Edge WebView2 is not already installed, the installer downloads it. This needs an internet connection.
  4. Open upstratus from the Start menu.

macOS

There is no macOS installer yet. A Mac build has to be made on a Mac and signed with an Apple certificate, and neither is in place. If you have access to the upstratus source code, you can build it yourself:

  1. Install Apple's command line tools: xcode-select --install.
  2. Install Rust from rustup.rs, then the Tauri command line tool: cargo install tauri-cli --version "^2".
  3. In the int_edgeai_client source folder, run cargo tauri build --bundles app.
  4. Open src-tauri/target/release/bundle/macos/upstratus.app. Because the build is not signed, the first time you open it you must right-click the app and choose Open.

A self-built Mac app signs in like any other copy, but it cannot set up a board yet.

Next

Sign the app in to your account. Choose Sign in, then approve the short code in your browser.