Help › Getting started

Install DeskRanger

Which edition you get on which device, and what happens on the first start.

FreemacOSWindowsiPhone & iPad · Coming soonWebAndroidLinux

DeskRanger is in Early Access. On the downloads page you download the app for your computer or phone: for the Mac as a disk image (.dmg), for Windows as an installer (.msi), for Linux as a deb or rpm package from DeskRanger's package source, for Android as an APK file. The account is free.

macOS

You need:

  • macOS 26 or later
  • Mac with Apple silicon (M1 or later)
  1. Download the disk image (“DeskRanger.dmg”) from the downloads page. Apple has notarized it.
  2. Open the image with a double click and drag DeskRanger onto “Applications”: an arrow in the window shows where. Then eject the image. Only in the Applications folder can the Mac later be reachable before login and update itself.
  3. Open DeskRanger and sign in, or create an account. If you start it from somewhere else (from the image, from “Downloads”), it asks once Move to the Applications folder? With Move to Applications DeskRanger copies itself into Applications and restarts there; if the folder is locked for you, macOS asks for an administrator. With Don’t Move DeskRanger keeps running where it is. Only the background service stays off then; the switch says why, and Move to Applications … does it later at any time.
  4. Under Set up DeskRanger you grant two permissions so others may see and control your Mac: Screen Recording and Accessibility (from macOS 27 the second permission is called “Device Control and Data Access”; DeskRanger always uses the name your Mac uses). Open System Settings opens the right place.
Set up DeskRanger: Screen Recording and AccessibilitySet up DeskRanger: Screen Recording and Accessibility

If you only want to reach other devices, you need no permissions. You can also postpone them with Set Up Later.

An optional step follows: Reachable before sign-in. Your own devices reach this Mac before sign-in and on the locked screen too, and DeskRanger updates itself without asking. macOS asks an administrator once, under “Login Items & Extensions”. Approve now opens System Settings at the right place, and the check mark appears by itself. With Later you leave it for now; the This Mac card on the dashboard and the settings keep offering it.

Set-up: the optional step “Reachable before sign-in” with “Approve now” and “Later”Set-up: the optional step “Reachable before sign-in” with “Approve now” and “Later”

You do not need the package (.pkg) to install: with the background service DeskRanger fetches and applies updates itself; IT management uses the same package to distribute it.

Reachable before login

The switch Reachable before login and while the screen is locked keeps your Mac reachable after a restart, at the login screen and while the screen is locked. macOS asks once for an administrator’s approval. You find the switch under Settings (⌘,) › This Mac, together with the full checklist. While the background service keeps your Mac reachable, Allow connections to this Mac shows on and cannot be turned off there; below it you read: “The background service keeps this Mac reachable, also before login. You can turn this off under “Reachable before login”.” If the background service is installed but not ready yet, the app keeps your Mac reachable itself and the switch works as usual. While the background service serves your Mac, it also decides Prevent sleep while remote access is on and Match resolution for sessions.

The switch “Reachable before login and while the screen is locked”The switch “Reachable before login and while the screen is locked”

At the bottom of the sidebar, the This Mac field shows in two lines whether your Mac is ready (Ready) or what is still to do, and how well it can be reached. A click opens a bubble: who is connected right now, the open tasks with one button each, and everything that is in order. The technical details (device ID, build) are folded; a click on them opens them (the picture shows them open). The login screen is only a note, not a task: Checked again at the next log-out or restart after the update. If macOS asks there about Screen Recording, choose “Allow”. That is so too when the test capture there did not work: DeskRanger repeats it a few times first and checks again at the next log-out; there is no warning or colour for it. You don’t need to do anything.

The bubble of the “This Mac” field (“This PC” on Windows): who is connected, everything that is in order, and the technical detailsThe bubble of the “This Mac” field (“This PC” on Windows): who is connected, everything that is in order, and the technical details

When Let my devices connect without asking is off, the field says Ready · asks first: your own devices ask first too, and someone at the Mac has to confirm each connection. While the background service serves your Mac, the settings under This Mac show its own switch. Turning it on asks macOS for an administrator (password or Touch ID); turning it off takes effect at once and never asks. While the change is being applied, macOS's question included, Switching … stands in place of the switch. If the background service is not responding, they say Unknown – The background service is not responding. What applies right now is unknown. When a session runs through the background service, the bubble shows since when, and End ends it; until the background service reports the end, it says Ending …

If the background service does not respond right now, the bubble shows the task Background service is not responding with a sentence on it: DeskRanger keeps trying, and it usually recovers by itself after a short while. Check again asks again at once. While it does not respond, Background service and permissions shows a question mark instead of a check mark.

If you changed the account in DeskRanger and the background service still belongs to the previous account, the bubble shows the task Background service on the previous account. Move … moves it; macOS asks for an administrator first. If the account row of the checklist is open then, it leads to Move … too. If the background service cannot follow (an older background service, or you are not at the device itself), the row offers no link and says: The background service belongs to another account. Sign in with that account, or reinstall DeskRanger. Afterwards Let my devices connect without asking is off until you turn it back on.

After a restart with FileVault

If FileVault is on, your Mac stops at its unlock screen after every restart and after a power failure. macOS is not running yet then – and neither is DeskRanger. Until someone enters the password at the Mac, it is offline, even with Reachable before login and while the screen is locked. That is on purpose: it keeps your data encrypted if the Mac falls into the wrong hands.

  • In Settings under This Mac, the section After a Restart explains this once with a picture. Got It turns it into a quiet row. If you turn FileVault off and later on again, the explanation comes back.
  • Your other devices show a small lock next to the system on this Mac’s card and the group Security in the device information.
  • Restart… in a session always asks first and shows that the Mac then waits for the password (see The session). Afterwards the card says Restarting… and, later if needed, Waiting for FileVault.

On every Mac that runs DeskRanger, macOS with Remote Login (System Settings › General › Sharing) also accepts the FileVault password over SSH from a device on the same network. Over Wi-Fi this only works on a network it already knows with WPA2 Personal, over a cable only without a network login; a cable is recommended. DeskRanger never turns Remote Login on itself. Whether you want it is your decision: it is one more door into your network.

A Mac without a display should start by itself after a power failure: turn on starting after a power failure in System Settings under “Energy”. With FileVault it then waits at its unlock screen.

Settings › After a Restart: FileVault or a BitLocker PIN explained, with “Got It”Settings › After a Restart: FileVault or a BitLocker PIN explained, with “Got It”

Open at login

For someone to accept requests on your Mac, DeskRanger has to run there. So while your Mac allows connections – also when Reachable before login and while the screen is locked keeps it reachable – DeskRanger opens by itself after you log in – without a window, only in the menu bar. You turn this off or on in Settings under General with Open at login; your choice then always applies.

If you turned DeskRanger off in System Settings under “Login Items & Extensions”, the switch says: macOS isn’t opening DeskRanger at login right now – it’s turned off under “Login Items & Extensions”. Open System Settings takes you there.

Windows

You download DeskRanger for Windows from the downloads page. It runs on these systems:

  • Windows 11 (x64, ARM64)
  • Windows 10 22H2 (x64)
  • Windows Server 2019 / 2022 (x64, with Desktop Experience)

More on the Windows page.

The file is an installer (MSI), digitally signed; its publisher shows as “Exenso”. Open it with a double-click. If Windows first shows “Windows protected your PC” (SmartScreen), check that the file came from the download page, then choose “More info” and “Run anyway”. Then Windows asks once for an administrator’s confirmation; if you have no administrator account, ask the person who manages the PC. A short setup guide opens: welcome, a progress bar and a final page with the ticked box “Start DeskRanger”. Leave it ticked and DeskRanger opens for you when you choose “Finish”; untick it to open DeskRanger later from the Start menu. It then runs as you, not as an administrator. DeskRanger is installed for everyone on this PC, in “Program Files” and the Start menu. PCs with an ARM64 processor get an installer of their own on the same page. On older systems the installer stops and says: DeskRanger needs Windows 10 22H2, Windows 11 or Windows Server 2019 with Desktop Experience (64-bit). You can reach older PCs without installing anything, over Remote Desktop from another DeskRanger device on the same network.

To deploy it in a company (Intune, Group Policy), msiexec /i DeskRanger-….msi /qn installs without questions and without that guide, and never starts DeskRanger. DESKTOPSHORTCUT=1 adds a desktop shortcut, MANAGEDUPDATES=1 turns DeskRanger’s own updates off when your device management distributes new versions itself. To remove it: msiexec /x DeskRanger-….msi /qn – this also removes the background service and its data.

Reachable before login

Under Settings › This PC, turn on the switch Reachable before login and while the screen is locked; the full checklist is there too. Windows asks once for an administrator’s confirmation: choose “Yes”. Then the rows turn green by themselves – Background service allowed, Linked to account and Sign-in screen ready – and DeskRanger shows Serves this PC. You don’t need to sign out and back in for it. While the background service keeps the PC reachable, Allow connections to this PC shows on and cannot be turned off there; below it you read: “The background service keeps this PC reachable, also before login. You can turn this off under “Reachable before login”.” After a restart, the PC is reachable again a few seconds after it starts up, even before anyone signs in. The background service talks only to an app from an install folder that only administrators can change. The installer protects the folder that way and installs only into its own folder under “Program Files”; it refuses any other folder (from the command line): “This folder is not protected. Please install DeskRanger in its standard folder under “Program Files”.” If another user can change the folder later after all, the app no longer links to the background service, and This PC shows “The DeskRanger folder is not protected. Please install DeskRanger again.” Install DeskRanger again then. One limit remains: a program that runs under your own Windows user can control the genuine DeskRanger app and so also accept a request. So install only programs you trust.

At the bottom of the sidebar, the This PC field shows in two lines whether your PC is ready (Ready) or what is still to do, and how well it can be reached. A click opens a bubble: who is connected right now, the open tasks with one button each, and everything that is in order. The same field is at the top of the menu in the taskbar’s notification area.

The bubble of the “This Mac” field (“This PC” on Windows): who is connected, everything that is in order, and the technical detailsThe bubble of the “This Mac” field (“This PC” on Windows): who is connected, everything that is in order, and the technical details

When Let my devices connect without asking is off, the field says Ready · asks first: your own devices ask first too, and someone at the PC has to confirm each connection. While the background service serves your PC, the settings under This PC show its own switch. Turning it on asks Windows for an administrator; turning it off takes effect at once and never asks. While the change is being applied, Windows' question included, Switching … stands in place of the switch. If the background service is not responding, they say Unknown – The background service is not responding. What applies right now is unknown. When a session runs through the background service, the bubble shows since when, and End ends it; until the background service reports the end, it says Ending …

If the service does not respond right now, the bubble shows the task Background service is not responding with a sentence on it: DeskRanger keeps trying, and it usually recovers by itself after a short while. If it really is not running, Restart starts it again; Windows asks for an administrator first. While it does not respond, Background service and permissions shows a question mark instead of a check mark.

If you changed the account in DeskRanger and the background service still belongs to the previous account, the bubble shows the task Background service on the previous account. Move … moves it; Windows asks for an administrator first. If the account row of the checklist is open then, it leads to Move … too. If the background service cannot follow (an older background service, or you are not at the device itself), the row offers no link and says: The background service belongs to another account. Sign in with that account, or reinstall DeskRanger. Afterwards Let my devices connect without asking is off until you turn it back on.

If you chose “No” in the Windows prompt, the row says Cancelled. Click Try Again to try once more.

With a BitLocker PIN

If BitLocker protects your PC with the TPM alone, Windows starts by itself after a restart, and with Reachable before login and while the screen is locked DeskRanger is reachable again right away. If BitLocker asks for a PIN at start, the PC waits at its PIN screen after every restart and power failure. Until someone enters the PIN at the PC, it is offline.

  • Under This PC, the section After a Restart explains this once with a picture; Got It turns it into a quiet row.
  • Your other devices show a small lock on its card and the group Security in the device information. DeskRanger’s background service reads this; without Reachable before login and while the screen is locked the PC reports nothing about it.
  • Unlocking over the network (“BitLocker Network Unlock”) exists in Windows only on company networks with Windows Server and Windows Deployment Services (WDS); Microsoft describes it in its BitLocker documentation.
  • After firmware or TPM changes, Windows may ask for the 48-digit recovery key instead of the PIN. The card then shows Waiting for BitLocker PIN or, after a while, only since when the PC has been offline.
Settings › After a Restart: FileVault or a BitLocker PIN explained, with “Got It”Settings › After a Restart: FileVault or a BitLocker PIN explained, with “Got It”

Open at login

For someone to accept requests on your PC, DeskRanger has to run there – even when the background service keeps the PC reachable. So while your PC allows connections – through DeskRanger itself or through Reachable before login and while the screen is locked – DeskRanger opens by itself after you sign in – without a window, only in the notification area of the taskbar. You turn this off or on in Settings under General with Open at login; your choice then always applies.

If you turned DeskRanger off in Windows Settings under Apps → Startup, the switch says: Windows isn’t opening DeskRanger at sign-in right now – it’s turned off under Apps → Startup. Open Windows Settings takes you there.

iPhone & iPad

You need:

  • iOS / iPadOS 26 or later
  1. The downloads page shows whether DeskRanger for iPhone and iPad is in the App Store yet, and takes you there.
  2. Install the app like any other.
  3. Open DeskRanger and sign in with your account.

Web

The web console needs no installation: click “Sign in” at the top of the website. You need:

  • Current versions of Chrome, Edge, Safari, Firefox
  • Not in a private window: the browser may not keep the device key there.

To add another device in the console, choose Add Device. It shows the three ways: install DeskRanger there and sign in with your account, with a link to the downloads page. Nearby and Add an existing remote desktop happen in the apps, because a browser cannot search your network.

Android

You need:

  • Android 8.0 or later
  • Device with a 64-bit ARM processor (arm64-v8a)
  1. Open the downloads page in your device's browser and download the APK file. The page names its checksum (SHA-256) and the fingerprint of the certificate it is signed with.
  2. Open the downloaded file. The first time, Android asks whether your browser or file manager may install apps; allow it and confirm the installation.
  3. Open DeskRanger and sign in with your account.

If someone should also be able to operate this device later (Getting help), Android 13 and newer blocks the accessibility service for apps that do not come from the Play Store: open DeskRanger's app info in the Android settings, tap the three dots and choose “Allow restricted settings”.

Linux

You need:

  • App and server package: Ubuntu 24.04 LTS, Ubuntu 26.04 LTS, Debian 13, Fedora 43, Fedora 44, RHEL / AlmaLinux / Rocky Linux 10
  • Server package only (no desktop app): Ubuntu 22.04 LTS, Debian 12, RHEL / AlmaLinux / Rocky Linux 8 and 9
  • Processor: x86-64, ARM64 (aarch64)

There are two ways; the downloads page shows the same commands to copy. Both set up DeskRanger's package source on your system, so updates come later through your package manager (apt, dnf or zypper):

  1. With one command: Open a terminal and enter curl -fsSL https://pkg.deskranger.app/install.sh | sh -s -- --desktop. The script checks the package source's key, says what it will do and asks on the terminal before it changes anything; then it installs the app. Without the --desktop option it installs the deskranger-server package for servers without a desktop instead.
  2. With your package manager: On Debian and Ubuntu you fetch the key with sudo curl -fsSLo /usr/share/keyrings/deskranger.gpg https://pkg.deskranger.app/deskranger.gpg and the package source with sudo curl -fsSLo /etc/apt/sources.list.d/deskranger.sources https://pkg.deskranger.app/setup/deskranger.sources, then you install with sudo apt update && sudo apt install deskranger. On Fedora and RHEL: sudo curl -fsSLo /etc/pki/rpm-gpg/RPM-GPG-KEY-deskranger https://pkg.deskranger.app/deskranger.asc, then sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-deskranger, then sudo curl -fsSLo /etc/yum.repos.d/deskranger.repo https://pkg.deskranger.app/setup/deskranger.repo and last sudo dnf install deskranger. The package key's fingerprint is 8168 05BF C5AB 28A4 CF6D DCA3 F339 AB41 2550 E989; compare it with what gpg --show-keys shows for the key you fetched. The same number is on the downloads page and in the release notes.

You install a single deb or rpm file from the page with sudo apt install ./file.deb or sudo dnf install ./file.rpm. That installs only this version; updates through the package manager need the package source to be set up.

Then open DeskRanger from your desktop's application menu and sign in. More on the Linux page, which also explains how to set up a server without a desktop.

After installing: which card to choose

On the first start DeskRanger asks what you would like to do (Switch the view). If you want someone to help you, choose Get help; you read the number you then see to the person. If you want to help someone, choose Give help. For everything else, including setting up your own devices, choose All features. You can switch at any time.

Windows

On Windows, DeskRanger opens with this question in a small window on the first start. A help link deskranger://hilfe opens Get help right away.

iPhone & iPad

On the iPhone and iPad the first card is called Show my screen: you show your screen so your helper can watch; they cannot control it, iOS does not allow that. A help link deskranger://hilfe opens this view right away.

If sharing says “Open DeskRanger once, then watching works.” (for example after the app crashed), open DeskRanger once and start sharing again.

Android

On Android this question replaces the sign-in on the first start: three cards stand one above the other, each with a picture. If you already have an account, tap I already have an account · Sign in at the bottom. A help link deskranger://hilfe opens Get help right away, deskranger://helfen opens Give help. After an update everything stays as it was: DeskRanger opens All features.

Updates

Should a bug ever interrupt the automatic update, DeskRanger tells you itself: a yellow strip with “DeskRanger needs to be updated once by hand.” appears at the top of the main window, with a short explanation from us when needed. It blocks nothing and also appears when you are not signed in. Open download page opens DeskRanger's download page; download the current version there and install it over the old one, your sign-in and settings stay. The strip goes away as soon as that version runs. The Mac, Windows and Linux (deb and rpm; with Flathub, Flathub does the updating) have it already. On the iPhone, iPad and in the Play Store version for Android the strip says “Please update in the App Store.” or “Please update in the Play Store.” instead and leads to the store page. The strip pushes the window's content down instead of covering it, and never appears inside a running session.

macOS

With Reachable before login and while the screen is locked on, DeskRanger updates itself. Installs automatically once no session has run for 2 minutes. A running session is never interrupted for it. After an update the Mac can be reached again within a few seconds, also when it is locked and nobody is at it. While the Mac is online it learns of a new version as soon as it is out; otherwise it looks regularly. In Settings under This Mac → Updates you see whether a new version is waiting and why, for example waiting: session in progress. Check now looks right away.

If you don’t want to wait, choose Install now. If sessions are running, DeskRanger names them first; sessions of your own devices continue afterwards. If something still runs in the app itself – a window to another device, a connection, a terminal –, it says installs as soon as no session runs any more: the update installs as soon as that has ended, never underneath it.

After an update the app restarts as well, so that it matches the new version. While something still runs in it – a window to another device, a connection being set up, an open terminal or a file you are editing – it waits and says so: Update installed – DeskRanger restarts once nothing is running and you haven't used it for a while. The Mac stays reachable meanwhile, and Check now keeps working. Even when nothing runs, it restarts only after you have left it alone for a while (no key or click in its windows), never in the middle of your work. Restart now restarts the app right away; its sessions and terminals end as they do when you quit.

With Reachable before login and while the screen is locked off, the app updates itself. It looks for a new version at start and once a day; Update automatically decides whether it also downloads it right away. This Mac → Updates shows what it found, Check now looks at once, and the DeskRanger menu has Check for Updates…. It installs when you quit the app or have not used it for a while – never during a session, a connection or an open terminal. It takes the same signed package as the background service and never asks for an administrator. If you may not change the app in the Applications folder yourself, it installs nothing and shows Please download the new version: download the new version from the download page then, or turn Reachable before login and while the screen is locked on and updates arrive without asking. If you turn Reachable before login and while the screen is locked on later, the background service takes over the updates and the app stops looking by itself.

Windows

DeskRanger updates itself. Under Settings → Privacy and info → Updates you see whether a new version is waiting and why, for example waiting: session in progress. Check now looks right away.

With Reachable before login and while the screen is locked on, the background service installs new versions by itself and learns of them as soon as they are out, while the PC is online: Installs automatically once no session has run for 2 minutes. DeskRanger closes for a moment and starts again by itself – your own windows to other devices count as sessions too while they are open. Install now does it at once; if sessions are running, DeskRanger first names everything that ends: sessions and requests, shared terminals – including the ones DeskRanger provides itself –, the people in your shared folders and DeskRanger in other Windows accounts on this PC. If someone else’s session is among them, you can only confirm directly at the PC or from one of your own devices. If DeskRanger cannot tell for sure where the click came from – for example from another remote support program –, it does not count then; click again directly at the PC.

Without the background service, DeskRanger looks for updates itself. Without the background service, Windows asks for an administrator's confirmation before each install. Then, too, DeskRanger first names everything that ends – the sessions and terminals it serves itself and DeskRanger in other Windows accounts on this PC –, with the same rule.

After an update the app restarts as well, so that it matches the new version – for instance when the background service or you installed the package. While something still runs in it – a window to another device, a connection being set up, an open terminal or a file you are editing – or while you are using it, it waits and says so above the device list, in the bubble of This PC and on the start page: Update installed – DeskRanger restarts once nothing is running and you haven't used it for a while. It restarts only when nothing runs and you have left it alone for a while (no key or click in its windows), never in the middle of your work. Restart now restarts the app right away; DeskRanger asks what it asks when you quit first, and its sessions and terminals end.

If an update stops with “Error 1722”, something other than DeskRanger is holding its folder; what to do is described in Windows update stops with error 1722.

iPhone & iPad

The store you installed DeskRanger from takes care of updates.

Android

The APK from the downloads page updates itself. It looks for a new version when you open it and downloads it right away on Wi-Fi; on a mobile network it waits until you choose Download. Under Privacy and info → Updates you see what it found, and Check now looks right away. With Install DeskRanger hands the new version to Android; Android asks whether you want to install it, the first time also whether DeskRanger may install apps. That does not work during a session: You can install once no session is running.

Only what DeskRanger checked first is installed: the version's signature, its checksum and that the APK is signed with the same certificate as the installed app. An older version is never installed. From the Play Store, updates come through Google Play; there DeskRanger does not look for them itself. You can still download a new version yourself from the downloads page and open the file: Android updates DeskRanger in place, and your account and settings stay.

Linux

The app does not update itself: updates come through the package manager, for example with sudo apt upgrade or sudo dnf upgrade. Under Updates in the settings you see the channel of this build and how the app is updated. A package update does not end a running session; the app restarts only when nothing in it is running.

DeskRanger's service (it runs without the app, on servers and with Reachable before sign-in) also looks for new versions itself and installs them through the same package manager as soon as nobody has used a terminal or a shared folder for a while; that never ends a running session either. Both ways follow the same channel: sudo deskranger channel shows it and changes it for the background service and the package source at once. More on the Linux page.

“DeskRanger couldn't start”

DeskRanger could not open its protected storage. Click Try Again. If that does not help, restart the Mac and open DeskRanger again. If your Mac no longer knows your keychain's old password (after a reset Mac password, for example), that does not help either: open Keychain Access and choose “Reset Default Keychains” in its settings. macOS creates a new keychain and keeps the old one; DeskRanger then starts as a new device. Sign in and remove this Mac's old entry from your device list.

“DeskRanger could not start”

DeskRanger keeps this device’s key in your desktop’s keyring (a “Secret Service” such as GNOME Keyring or KWallet). If none runs, DeskRanger shows a notice at start. Install “gnome-keyring” (for example sudo apt install gnome-keyring or sudo dnf install gnome-keyring) or, on KDE, “kwalletmanager”, sign in to your desktop again and open DeskRanger once more. The technical message is behind “Technical details”; give it to support if it still does not work.

“Windows can't open this user's keys right now – usually after a password change or a sign-in with the PIN. Sign out once and sign back in with your Windows password. If that doesn't help, set up DeskRanger again on this PC with “Set up again”. Once Windows can open the keys again, DeskRanger starts by itself.”

Windows can't open your user account's keys right now. This affects every program that protects something with them (saved passwords in the browser, for example), not only DeskRanger.

  • After a sign-in with the PIN: Sign out once and sign back in with your Windows password (at the sign-in, "Sign-in options", then the key icon).
  • After the password was changed elsewhere (online at your Microsoft account, for example) or reset: Windows opens the old keys only with the old password. So change a password on the PC itself (Ctrl+Alt+Del, "Change a password"); then everything stays.
  • If neither helps, set up DeskRanger again on this PC: Click Set up again and confirm the question. DeskRanger puts the old folder with the keys into a new folder (for example identity-alt-2026-10-15-1\identity) and deletes nothing in it. Then sign in; with DeskRanger Secure you approve the PC on one of your other devices. Afterwards remove this PC's old entry from your device list. What only this PC had saved, such as the network book and remembered servers, is gone afterwards. The background service is not affected.
  • The old password turns up again: This only works while this PC's old entry is still in your device list. Quit DeskRanger, and in File Explorer under %LOCALAPPDATA%\DeskRanger rename the new identity folder and move the identity folder from identity-alt-… back into its place.

Once Windows can open the keys again, DeskRanger starts by itself; Try Again works too.

With the background service protecting them, a password change no longer stops the start. At the first start after the update the app keeps a copy of its old data folder beside the new one: %LOCALAPPDATA%\DeskRanger\identity-dpapi-<date>, after a re-seal also identity-sealed-<date>, and after an interrupted move identity-sealing-<date>. DeskRanger never deletes these folders. You may delete them by hand after about a week of normal use. They hold your old sign-in and old device key – do not hand them to anybody.

“DeskRanger couldn't read its data in this device's keystore. Try again; if that doesn't help, restart the device. If that doesn't help either, set up DeskRanger again on this device with “Set up again”.”

DeskRanger couldn't read its data in this device's keystore (Android Keystore). Tap Try Again. If that doesn't help, restart the device and open DeskRanger again. A removed screen lock or a new fingerprint does not affect DeskRanger here.

Rarely the keystore loses DeskRanger's key for good, after a system update for example. Then a restart doesn't help either: tap Set up again and confirm the question. DeskRanger puts the old data aside in a folder of its own and deletes nothing of it. Then sign in; with DeskRanger Secure you approve the device on one of your other devices. Afterwards remove this device's old entry from your device list.

“Background service not responding”

DeskRanger’s background service isn’t running. Click Restart in the row and confirm the Windows prompt with “Yes”.

The editions from the stores

The editions from the Mac App Store and the Microsoft Store are the same app as the one from the download page. What the store does not allow is switched off, and the app says why at that place. Your plan applies the same in every edition.

macOS

DeskRanger Lite from the Mac App Store runs in the app sandbox, without a background service. It lacks:

  • Reachable before login and while the screen is locked: the Mac is reachable only while you are logged in and the app is running. Settings say why under Reachable before sign-in.
  • Its own updates: the Mac App Store updates the app.
  • The Mac's desktops (Spaces) for your other devices.
  • The local shell and sharing this Mac's terminal; SSH to other devices works.

So that your devices reach a Mac with DeskRanger Lite without asking while you are logged in, turn on Reachable while you are logged in under Reachable before sign-in: Lite then starts in the menu bar when you log in. Without this yes, Lite never starts by itself. Your other devices show under Technical details which edition runs there and what it limits.

Windows

DeskRanger from the Microsoft Store comes without the background service. It lacks:

  • Reachable before login and while the screen is locked and access while nobody is signed in: the PC is reachable only while you are signed in and the app is running. Settings says why at that place.
  • The BitLocker PIN hints and restarting the PC remotely.
  • Its own updates: the Microsoft Store updates the app.
  • Virtual machines and containers.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Removing DeskRanger

Removing the program and taking the device out of your account are two steps. You take the device out of your account on another device with Remove from My Devices… (Removing a device from the account); it can then no longer connect. You remove the program like this:

macOS

In the “DeskRanger” menu (or in Settings › General), choose Remove DeskRanger …. DeskRanger asks once whether your account data stays on this Mac (preselected: yes), and macOS asks once for an administrator’s password. Then the app, its background service and the service’s entries in macOS are gone, and DeskRanger tells you what it removed. If you keep the account data, a new installation is signed in at once and is the same device again; otherwise DeskRanger also deletes this Mac’s sign-in, device key, settings and logs.

If you only drag DeskRanger to the Trash, the background service stays behind. The Mac App Store edition has none; you drag it to the Trash like any app.

Windows

Open the Windows settings, choose Apps, then “Installed apps”, and uninstall DeskRanger there. That also takes the background service and its data with it. In a company, msiexec /x does it (see above).

iPhone & iPad

Press and hold DeskRanger's icon on the Home Screen and choose “Remove App”.

Android

Remove DeskRanger in the Android settings under Apps, like any other app.

Linux

sudo apt remove deskranger (Debian, Ubuntu) or sudo dnf remove deskranger (Fedora, RHEL) removes the app; for the server package use deskranger-server instead of deskranger.

As with other packages, the device's data (device key, logs) stays, so a new installation is the same device again. sudo apt purge deskranger deletes it too; on Fedora and RHEL, delete it with sudo deskranger forget before removing the package.

What stays everywhere: your account with its other devices, and your recovery key. Neither lives only on this device, and only Remove from My Devices… takes the device out of your account.

The background service

The background service is its own part of DeskRanger on the computer. It keeps running when the app is closed or being updated, so a session continues. It links itself to the account you are signed in with. The app shows its state and build, and lets you restart it or remove it.

Moving from the separate DeskRanger Host to the app

macOS

If your Mac still has the earlier, separate DeskRanger Host package installed, the app offers to take over its job: Move DeskRanger Host into the app. The Mac keeps the same device ID, and only one entry is left in the privacy settings. Choose Take Over… and confirm.

First you allow the app's background service under "Login Items & Extensions". Then macOS asks once for an administrator password and removes the separate DeskRanger Host. Until then it keeps serving the Mac; a running session is interrupted briefly and carries on. If you cancel or it does not work, the app says so, and the separate DeskRanger Host keeps serving the Mac. It never goes ahead without a Host serving the Mac.

Windows

On Windows there is no separate Host package to move from. The background service takes the app's identity when you switch it on.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Was this helpful?

Checked for version 0.1.0 · as of 2026-11-13