Install the UUMit Desktop App

What you can do

Once the app is installed, apps on this computer can be opened through your Agent address. It needs no admin rights, doesn’t change your network settings, and doesn’t open any ports on your computer.

System requirements

System	Version	Architecture
macOS	13 or later	Apple silicon, Intel
Windows	10, 11	x64
Linux	Ubuntu 22.04 / 24.04, Debian 12	x64, arm64
Docker	Engine 24 or later	x64, arm64

Note

Download the installer for your system from the download page. The page recommends the build that matches your system.

Install

macOS

1. Download the macOS installer, open it and drag UUMit into Applications.
2. On first launch, UUMit opens your browser at “Connect this computer”.
3. Check the confirmation code and click “This is my computer, connect”.

Windows

1. Download the Windows installer and double-click it. It installs for your user only, so no admin rights are needed.
2. When it finishes, UUMit opens your browser at “Connect this computer”.
3. Check the confirmation code and click “This is my computer, connect”.

Linux

1. Download the .deb package for your system and install it:

   sudo apt install ./uumit-connector_<version>_amd64.deb

2. Connect this computer. The terminal prints a confirmation link and QR code — open it on your phone:

   sudo -u uumit UUMIT_CONNECTOR_HOME=/var/lib/uumit-connector uumit-connector connect

3. Run it in the background and start it at boot:

   sudo systemctl enable --now uumit-connector

For your user only, you can use a user-level unit instead: systemctl --user enable --now uumit-connector.

Docker

Put the app and OpenClaw in the same compose file, and keep credentials in a mounted volume (readable only by the container user):

services:
  openclaw:
    image: <OpenClaw image>
  uumit:
    image: <UUMit desktop app image, see release page>
    command: ["run", "--headless"]
    volumes:
      - uumit-data:/data
    restart: unless-stopped
volumes:
  uumit-data:

After the first start, find the confirmation link in the logs with docker compose logs uumit and open it on your phone.

Verify the download

The release page lists a SHA-256 for every installer. Compare it after downloading:

macOS

shasum -a 256 <installer file>

Windows

Get-FileHash <installer file> -Algorithm SHA256

Linux

sha256sum <installer file>

If it doesn’t match the release page, don’t install it — download it again from the official site.

If your antivirus blocks it

What happened: your antivirus blocked or quarantined UUMit. Why: the app keeps a long-lived outbound connection, which some antivirus tools flag. How to fix: check the SHA-256 as above; if it matches, add UUMit to your antivirus allow list. Instructions for the major antivirus products will be added here once testing is done.

Slow downloads in mainland China

A mainland mirror of the Docker image will be listed here at launch.

Handy commands

To do this	Run
Check status	uumit-connector status
Pause all apps	uumit-connector pause
Resume	uumit-connector resume
Check for updates	uumit-connector update --check
Create a diagnostics bundle (no credentials)	uumit-connector diag

Uninstall or switch computers

• Switching computers: remove the old one under “My computers” on the web first, then connect the new one. Your address stays the same.
• Disconnect this computer: uumit-connector unpair --yes, then uninstall as usual for your system.
• On Linux, /var/lib/uumit-connector is kept after uninstalling; delete it by hand once you’re sure you don’t need it.