Remote Access

Remote Access

Remote Access lets you work on one Clauge desktop from another device. The computer you want to reach is the host. The device you reach it from is either another Clauge desktop, using Remote mode, or the Clauge mobile app on iOS or Android. Use it to check on agent sessions, answer an agent that is waiting for input, or open files and a terminal on a computer you are not sitting at.

The two devices connect over your local network or your tailnet. Your organization's policy can turn Remote off.

Set up the host

Do this on the computer you want to reach.

  1. Open Settings → Remote Access.
  2. Under Remote access server, turn on Enable remote access.
  3. Note the address shown next to Running at. The port starts at 7431.
Remote Access settings on the host.

Pair a device

Pairing uses a one-time code that expires after two minutes, and the host has to approve each request.

On the host:

  1. Open Settings → Remote Access.
  2. Under Add device, select Generate code. The card shows the Pairing code, the time left under Expires in, the addresses under Reachable at, and a QR code.

On another Clauge desktop:

  1. Open Remote from the sidebar.
  2. Select Add device.
  3. Enter the host's address in Host and its port in Port.
  4. Enter the Pairing code.
  5. Optionally enter a Device name.
  6. Select Pair. The button shows Waiting for approval….

On a phone:

  1. Install the Clauge mobile app. The Get the app card on the host has QR codes for the Android and iOS download pages.
  2. In the app, scan the QR code on the host's Add device card, or enter the pairing code.

Back on the host:

  1. Approve the pairing request. A request that is not approved within a minute fails, and you start again.

If the code expires before you use it, select Regenerate.

Work on the host from another desktop

Open Remote from the sidebar and select a device under DEVICES. The dot next to its name shows whether it is online. Then choose a surface under SURFACES:

Surface What it does
Agent Lists the agent sessions on the host and opens them. Sessions are marked when they are live or awaiting input.
SSH Opens the SSH profiles saved on the host.
Files Browses the host's files. You can open and edit a file, create files and folders, upload, download and delete.
Terminal Opens a terminal on the host.
Browser Lists the ports listening on the host and previews them. Enter a port such as 3000, or a URL.
Stats Shows CPU, memory, battery and storage of the host.

To leave a device, select Back to devices or Close device. To forget it on this computer, open the device's menu and select Remove device.

Everything in Remote runs on the host. Terminal mode and the SSH and Explorer modes run on the computer you are sitting at.

Manage paired devices

On the host, Settings → Remote Access → Connected devices lists the phones and desktops allowed to connect.

Action Effect
Revoke Stops the device from connecting.
Remove Removes the device from the list.
Clear revoked Removes all revoked devices from the list.

Notifications to paired devices

The Notifications card on the host chooses which session events are pushed to your paired devices.

Setting Notifies when
Task complete A task finishes. After running at least sets a minimum task duration, and Only when I'm away limits it to times when the desktop is not in focus.
Approval & input An agent needs input or approval.
Session ended A session ends.

Select Send test to check that notifications arrive.

What’s next