Get started
DocsComputes / Install and add a Compute

Computes

Install and add a Compute

Install the Uremot desktop app or the uremot binary, and enroll a machine as a Compute in your workspace.

Updated

View as Markdown
On this page

A Compute is a machine you enroll into a workspace to run your desks and services. By installing Uremot you agree to the Software License Agreement.

To run desks and services, a Compute needs a container engine: on Linux Docker Engine, on macOS or Windows Docker Desktop. On Linux, a Compute that runs as your user needs you in the docker group: sudo usermod -aG docker $USER, then log out and in.

In the Console, open Computes and press Add a Compute, then choose:

  • Desktop computer, a computer you sit at, on macOS, Windows or Linux: the desktop app, below.
  • Headless Linux server, Linux on x86_64 or aarch64 with no screen of its own: Add a Linux server.

On macOS or Linux, the install line on the home page, curl -fsSL https://get.uremot.com | sh, installs uremot for you alone: the machine is a Compute only while uremot compute run runs, and nothing starts it again after a reboot. On a server that stays on, install the system service instead (Add a Linux server): it starts with the machine. On Windows, the home page's PowerShell line installs uremot.exe, and the computer joins through the desktop app, below.

Desktop computer#

  1. On the Desktop computer tab, download the app for your system: macOS, Windows or Linux.
  2. Open it and press Continue. Your browser opens: approve the code the app shows.
  3. Back in the app, enter a Machine name, choose the Workspace, and press Join.

The page in the Console ticks off Joined and Online as the machine connects.

Let people see this computer's screen#

To let people in your workspace watch and use the computer's own screen, turn on Allow remote access in the app. It's off until you turn it on.

On macOS, the app also needs your permission. If it says macOS is blocking screen capture, press Open Screen Recording settings, allow Uremot, then quit and reopen the app. If viewers can watch but not control, press Open Accessibility settings and allow Uremot there.

Run workspace apps, on by default, lets this machine run its workspace's desks and services in containers. Turn it off to keep the computer to remote access alone.

Headless Linux server#

This now has its own page: Add a Linux server.

Without systemd#

See Add a Linux server, without systemd.

Services#

Databases and other servers your agents use now have their own page: Services and the workspace network.

Workspace network#

See Services and the workspace network, across Computes.

Next: Connect a harness.