Skip to main content

Introduction to Remote Desktop

Swif Remote Desktop lets admins see and control a managed device's screen from the Swif console, to help users, troubleshoot, or fix settings. It works on macOS, Windows, and Linux. Android is coming soon.

Swif Remote Desktop is Swif's own version of RustDesk, the open-source remote desktop tool, with Swif's branding, running on Swif's own servers.

Splashtop will be retired soon. In Swif, Splashtop is marked Deprecated Soon. Use Swif Remote Desktop for new setups.

For a command line instead of the screen, see How to Use Live Terminal.


Set up Swif Remote Desktop

Assign the Swif Remote Desktop policy for each platform, with Enable Swif Remote Desktop on. Swif installs Swif Remote Desktop on the devices, keeps it up to date, and sets its access password.

Platform

Policy

Requirements

macOS

macOS 12 or later, Swif agent 1.368.0 or later

Windows

Windows 10 or later, Swif agent 1.339.0 or later

Linux

A signed-in desktop session, Swif agent 1.427.0 or later

The policies work on company-owned and BYOD devices.

Moving from the RustDesk policies

The Swif Remote Desktop policies replace the earlier Remote Desktop (RustDesk) policies. When you assign the new policy, the Swif agent removes RustDesk from the device, and installs Swif Remote Desktop. Assign the new policy, then unassign the old one.


Connect to a device

  1. In Swif, open the device, and click Remote Desktop.

  2. Under Swif Remote Desktop, check the status:

    • Configured: Connect - The policy is assigned, and Swif Remote Desktop is on

    • Not Configured: Configure - There's no policy for your team, the device isn't assigned one, or Swif Remote Desktop is off for it. Configure helps you create, assign, or turn on the policy.

    The menu also lists what the device needs, such as the policy, and, on macOS, permissions.

  3. Click Connect. Swif shows the device's Connection ID and Password.

  4. Open the Swif Remote Desktop app on your computer, and enter them to start the session.

Get the app for your computer from the Remote Desktop window, for macOS, Windows, or Linux. Download buttons are shown to admins.

If the details aren't ready, Swif shows a message instead of the ID and password. Click Retry, or Refresh if the device is still setting up.


How sessions work

Details

Where sessions connect

Through Swif's own server, rustdesk.swifteam.com. Swif Remote Desktop never connects to RustDesk's public servers, or other relays.

Asking permission

The user isn't asked to allow each session, and there's no setting to require it yet. Let users know before you connect.

During a session

Swif Remote Desktop's window shows on the device, so the user knows someone is connected. The user can end the session from it.

Lock screen

On macOS and Windows, you can connect when the device is locked, or a user is signed in. On Linux, a user must be signed in to the desktop.

What's recorded

Recorded

Not recorded

Each time an admin clicks Connect. The device's Activity Log shows Connected to remote desktop, with the admin, and the time.

When a session ends, or how long it lasted

What was done during the session


macOS permissions

Swif Remote Desktop needs two macOS permissions. The user allows each one once:

Permission

Needed for

How the user allows it

Screen Recording

Seeing the screen

The policy's configuration profile lets the user approve it. macOS asks them once.

Accessibility

Controlling the mouse and keyboard

macOS asks the first time you connect

Before your first session, ask the user to approve both. If you can see the screen but not control it, or the screen is black, ask them to check both permissions:

  1. Open System Settings > Privacy & Security.

  2. Under Screen Recording, and under Accessibility, turn on Swif Remote Desktop.

  3. If asked, quit and reopen Swif Remote Desktop.

When macOS asks, the user clicks Open System Settings, and turns on Swif Remote Desktop.


Who can use Remote Desktop

Admins who can open a device in Swif can use Remote Desktop on it. To turn it off for your whole organization, see How to Disable Location Tracking, Live Terminal, and Remote Desktop in Swif.

Turning off the policy doesn't remove the app yet. If you turn off Enable Swif Remote Desktop, or unassign the policy, Swif Remote Desktop keeps running on the device for now. A fix is in progress. To stop remote access now, turn off Remote Desktop for your organization.


Splashtop

Splashtop is marked Deprecated Soon. If you still use it:

  1. Assign the Apple Remote Desktop (Splashtop) Policy, or the Windows Remote Desktop (Splashtop) Policy. Windows devices need a restart afterward.

  2. Click Remote Desktop on the device, and under Splashtop, click Connect.

  3. The first time, install the Splashtop viewer on your computer. Then click Launch Application, and Splashtop for RMM.

To control the device, not just view it, it must have granted Splashtop the permissions it needs.


Troubleshooting

Swif Remote Desktop shows Not Configured

  • Check that the device is assigned the Swif Remote Desktop policy for its platform.

  • Check that Enable Swif Remote Desktop is on in the policy.

  • Check that the device's Swif agent is new enough. See Set up Swif Remote Desktop.

No Connection ID or Password appears

Click Retry. If it still doesn't appear, check that the device is online, and that Swif Remote Desktop is installed on it.

The screen is black, or you can't control a Mac

Check the Mac's Screen Recording and Accessibility permissions. See macOS permissions.

You can't connect to a Linux device

On Linux, a user must be signed in to the desktop. See Linux Swif Remote Desktop Policy.


FAQ

Is Swif Remote Desktop the same as RustDesk?

It's Swif's own version of RustDesk, with Swif's branding, connecting only to Swif's server. It replaces RustDesk on your devices when you assign the new policy.

Does Swif use RustDesk's public servers?

No. Sessions go through Swif's own server, rustdesk.swifteam.com.

Can I require users to approve each session?

Not yet. Users aren't asked, but they see Swif Remote Desktop's window during a session, and can end it.

How do I see who connected to a device?

Open the device, and go to Activity Log. Look for Connected to remote desktop, with the admin and the time.


Related resources

Did this answer your question?