Help › Getting started

Create an account and sign in

One account for all your devices: with email and password, or with Apple, Google or Microsoft.

macOSWindowsiPhone & iPad · Coming soonWebAndroidLinux

You sign in with the same account on all your devices. That is how they find each other, and how your own devices may connect to one another.

Create an account

macOS

  1. Open DeskRanger and choose Create Account.
  2. Enter Name, Email and Password and confirm with Create Account.
  3. Or use Sign in with Apple, Sign in with Google or Sign in with Microsoft. If there is no account yet, DeskRanger creates it on the first sign-in. Google and Microsoft open in a browser window.
Create an account with name, email and password, or with Apple, Google or MicrosoftCreate an account with name, email and password, or with Apple, Google or Microsoft

iPhone & iPad

  1. Open DeskRanger and tap Create Account.
  2. Enter Name, Email and Password, or use Sign in with Apple, Sign in with Google or Sign in with Microsoft.
Create an account with name, email and password, or with Apple, Google or MicrosoftCreate an account with name, email and password, or with Apple, Google or Microsoft

Web

In the web console you sign in with email and password. A new account is created there only through Sign in with Apple, Sign in with Google or Sign in with Microsoft; otherwise create it in an app.

Below the form, DeskRanger links the Terms of Use and the Privacy Policy. By creating the account you agree to the Terms of Use.

Forgot your password

  1. On the sign-in page, choose Forgot password?.
  2. Enter your account’s email address and choose Send link.
  3. Open the link in the email. It opens a page in your browser where you set a new password.
  4. Then sign in with the new password. The new password signs you out in every browser; your apps stay signed in.
  5. In the web console you then see your devices first (Check your devices). If you do not know one of them, remove it right away: immediately after the reset you need no further code for that.
“Reset password”: the account’s email address and “Send link”“Reset password”: the account’s email address and “Send link”

If you see Your password is changed, but not every browser was signed out. Request a new link and reset the password with it once more. instead of the confirmation, the password is already changed: request a new link with Forgot password? and reset it once more with it, then every browser is signed out. With The password could not be changed just now. The link still works: try again in a moment. nothing changed, and the same link still works.

DeskRanger does not reveal whether an address has an account: the answer is the same for every address. If no email arrives, check your spam folder and the address. Forgot password? only appears when DeskRanger can send email.

“The email can't be sent right now. Try again later.”

DeskRanger cannot send email right now. Try again in a few minutes.

Access blocked

If an owner has blocked a person's access, DeskRanger refuses every sign-in, in all apps and in the web console, with the same sentence: Access to this account is blocked. Please contact DeskRanger support. It is not a wrong password, and a new password changes nothing. Contact DeskRanger support. A device that is already signed in says the same sentence at „This device“ instead of going online; it asks again about every 15 minutes, so an unblock is noticed without signing in again.

Apple or Google for an existing account

If you already have an account with a password, DeskRanger joins an Apple or Google sign-in to it only when both have confirmed the same email address. That way nobody gets into your account with someone else’s address.

“Confirm your email address first. There's already a DeskRanger account with a password for this address: sign in with it and choose “Confirm Email” under “Account”. After that, you can also sign in with Apple or Google.”

Confirm your account’s email address first: sign in with your password and choose Confirm Email under Account. After that, signing in with Apple or Google works.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Web

In the web console the Account page says Email Address Not Confirmed. Confirm Email sends you the link. Once you have opened it, choose Check Again; when you come back to the console it also checks by itself.

Sign in with Microsoft

Sign in with Microsoft works with a personal Microsoft account and with a work or school account. The button appears as soon as DeskRanger offers sign-in with Microsoft. It opens in a browser window, like Google.

DeskRanger never joins a Microsoft sign-in to an account that already exists, not even with the same email address. For work and school accounts the organization sets the address, so the address alone does not tell us reliably that it is you. Microsoft therefore only creates new accounts.

“There's already a DeskRanger account with this email address. We didn't connect this sign-in to it: we connect Apple and Google only when they report the address as verified, and Microsoft never. Sign in the way you usually do, for example with email and password.”

There is already a DeskRanger account for this address. Sign in the way you usually do: with email and password, with Apple or with Google.

A code for every new device

When you sign in with email and password on a device or in a browser that was never signed in to your account before, DeskRanger sends you a code by email. You type it on the new device; there is never a link to click for it. The email names the device and roughly where it is. Instead of the code you can also confirm the sign-in on one of your devices. Only then can the new device do anything in your account, so the password alone is not enough. Apple, Google, Microsoft or a passkey need no code.

If you remember this browser when signing in, DeskRanger temporarily stops asking it for the code. If you sign that browser out from elsewhere, choose Sign out everywhere else under sign-in activity or reset your password, it asks again next time.

Sign in a server without a screen

A server or NAS without a screen signs in with a code. Run deskranger login --code there; the device shows an eight-character code, for example KQ7M-4TZP. Open DeskRanger on your Mac, Windows PC, iPhone, iPad or Android phone, choose Add Device › Sign in with a code and type the code. DeskRanger then shows you what kind of device is asking, with its name and roughly where it is. The device states its name and kind itself: only approve it if you are setting it up yourself right now. Approve confirms with Touch ID, Face ID, Windows Hello or your phone's screen lock; with Decline the device is not signed in. The server then shows the account's name and masked e-mail address and asks „Sign in to this account? [y/N]“. Only an explicit „y“ takes the account; Enter means no. That way the server does not end up in someone else's account who happened to see the code and typed it in. In scripts --yes takes the account without asking.

You type the code only here, never through a link or in a browser. It is valid briefly and only once. DeskRanger never asks for it by phone, chat or e-mail. With DeskRanger Secure the device then shows six digits that you enter on your device; only then does it belong.

If the code does not match, it is wrong, expired, already used or belongs to another account: have the device show a new one. Only a device that belonged to your account before the request can approve: an app on Mac, Windows, iPhone, iPad or Android, not a browser, and not one that was itself signed in only by a code. Waiting for your approval never counts as an attempt; only after too many new codes does it ask you to try again later, after the waiting period. Ctrl+C cancels as long as the server is not enrolled yet; once the enrolment is under way the server finishes it, and you can remove the device afterwards in an app of your account.

Remove a device from the account

When you remove a device from your account (Remove from My Devices…), it can no longer connect, and nobody can connect to it, until it signs in again. After removal, new connections require another sign-in. Once the removed device learns of the removal, it shows ‘Connection ended: the device was removed from the account’. That also holds when DeskRanger is closed on the device right now: at its next start it does not add itself back to the account. The DeskRanger server, too, lets it back in only after a new sign-in. When you remove a browser, it is also signed out and no longer remembered: at its next sign-in with the password, DeskRanger asks for the code there again, as on a new device. Browsers that were never a device in your account are signed out too; the browser you are removing from stays signed in. The browser’s “don’t ask again for 8 hours” windows end with it.

With DeskRanger Secure, Remove from My Devices… in the app's device list goes straight into the real removal, the same flow as under Security, with no extra step: you confirm it with this device's key, and afterwards the device cannot make itself trusted again with just a new sign-in. The web console cannot do this, because a browser cannot confirm. There, instead of the delete button, it says: "With DeskRanger Secure you remove a device in the app on one of your devices.".

In the web console you confirm Remove a device once more: with the code by email, a passkey, your authenticator app, a recovery code or on one of your devices that has been in the account at least as long as the one removed, never with the password alone. One confirmation covers the whole computer, also when the list shows it as the app and the host.

If you remove a device in the app that has been in your account longer than the device you are on, DeskRanger asks for the same confirmation: “Removing an older device needs a confirmation.” This also applies when you make room on a new device. From an older device you remove a younger one without a code, so you can remove a lost phone at once.

What the removed device keeps: removing it deletes nothing on the device. If you sign it in again, it comes back as a new device with a new key. It sets its previous keys and the passwords synced with your devices aside instead of deleting them, and it still knows your other devices. What it set aside stays behind the device's unlock, is never sent anywhere and goes with Delete Account… or a switch to another account. The new device cannot use it yet.

What can be deleted: with DeskRanger Secure, a removal you confirm on a Mac, iPhone, iPad or Android device that knows the removed device through your six digits can delete its keys and synced passwords there as soon as the device learns of it: Windows and Linux with the background service when the background service starts, a Mac with DeskRanger Host once a user is logged in, all others when the app runs. Do not rely on a lost device deleting anything: a device that never comes online again, or that does not know you that way, keeps what it has behind its unlock. It stays out of your account all the same.

“Sign in again to add it back. If that wasn't you, change your password.”

The device was removed from your account, in another app, in the web console or on the device itself. Choose Sign In Again and sign in; after that it is in your account again as a new device. What it had before it sets aside instead of deleting it (see above). If that wasn’t you, change your password.

“This browser was removed from your account”

This browser was removed from your account, in an app, in another browser or here. The web console says so above every page. Choose Sign In Again and sign in again (with the password you need the code again); with the next session the browser is in your account again. If that wasn’t you, change your password.

Sign in when every slot is taken

If you sign in on a device while as many devices already allow connections as your plan permits, it still joins your account, just without connections to it: from it you connect to your other devices, but nobody connects to it yet. It takes no slot. On a Mac or PC, DeskRanger shows Device limit reached; the web console, Linux and the phone show the same message. On a Free plan it offers Buy Pro (not in every store version), and to free a slot it leads to your devices. If the background service serves the device and waits for a free slot, the This Mac or This PC field says Waiting for a free place; as soon as a slot is free it carries on by itself.

To make room, choose Show These Devices…: the list Devices That Allow Connections shows the devices that take a slot. Remove one you no longer need there, or turn off connections on one of them. You can do this on the new device too, because it already belongs to your account. If DeskRanger Secure is on, approve the new device first; until then it can't remove another device.

macOS

Once a slot is free, turn on Allow connections to this Mac on the new Mac. Only then does it take a slot, and your other devices can connect to it. If Reachable before login and while the screen is locked is on, the Mac's background service takes the free slot by itself, without a restart.

Windows

Once a slot is free, turn on Allow connections to this PC on the new PC. Only then does it take a slot, and your other devices can connect to it. If Reachable before login and while the screen is locked is on, the PC's background service takes the free slot by itself, without a restart.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Sign in with a different account on a device

A device belongs to the account it was last signed in to. When you sign in on a device with a different account, DeskRanger first asks whether the device should change its account. The question appears only when the account really changes: not at a first sign-in, not for the same account, and not after Delete Account… on this device. It appears for every way of signing in, and at the start of DeskRanger too when the device is signed in with another account than the one it belongs to. The device names the account from its own memory; the question does not come from the DeskRanger server, and only you at the device can answer it.

macOS

Sign-in screen with the question “This device belongs to …’s account” and the buttons “Cancel” and “Switch Account”Sign-in screen with the question “This device belongs to …’s account” and the buttons “Cancel” and “Switch Account”

iPhone & iPad

This function is coming soon to iPhone & iPad.

Android

Sign-in screen with the question “This device belongs to …’s account” and the buttons “Cancel” and “Switch Account”Sign-in screen with the question “This device belongs to …’s account” and the buttons “Cancel” and “Switch Account”
  • Switch Account: The device then belongs to the new account. The list of DeskRanger Secure and the settings of the previous account no longer apply on this device. Let my devices connect without asking is off after the switch until you turn it on again: until then you confirm every connection at this device, including those from the new account’s devices.
  • Cancel: Nothing changes. The device stays in the previous account, and the sign-in with the new account ends.

macOS

No key switches the account: Return does not answer the question, and Esc stands for Cancel. You confirm the switch with a click on Switch Account.

Windows

No key switches the account: Enter does not answer the question, and Esc or closing the window stands for Cancel. You confirm the switch with a click on Switch Account.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Android

No key switches the account: Back and a tap outside the window stand for Cancel. You confirm the switch by tapping Switch Account.

Switch Account does not remove the device from the previous account’s device list. If it is still listed there, it does not change: DeskRanger signs you out again and tells you what to do.

“This device is still listed in …’s account. Remove it from the device list there, then sign in here again.”

Remove the device from the previous account’s device list (Remove from My Devices…), on another device of that account or in the web console, then sign in here again.

Access before sign-in when the account changes

When Reachable before login and while the screen is locked is on, your device's background service belongs to an account. When the device changes its account (see above), the background service does not change with it by itself: it is moved only after an administrator of this device has authenticated to the system for it. The prompt comes from the operating system, not from DeskRanger.

macOS

  • You are an administrator of this Mac: The question about the change says so in its last sentence. Right after Switch Account, as soon as the device is signed in to the new account, macOS asks for an administrator: the macOS dialog shows DeskRanger and one sentence about what is moved, and asks for your password. Only then is the background service moved. If you cancel the prompt, nothing changes at the background service and no error appears; your change of account in the app stands, the background service stays with the previous account.
  • After the move the service is a new device in the new account: if DeskRanger Secure is on there, a device of the new account has to approve it first. Let my devices connect without asking is off for it: connections from your own devices are asked about at the device. At the lock screen and before sign-in nobody can accept, so no connection comes about there.
  • You are not an administrator: You are not asked for a password. Access before sign-in stays with the previous account, even though you switched in the app. The question tells you: “Access before sign-in stays with the previous account. An administrator of this device can move it.” Until an administrator moves it, only the devices of the previous account can reach it.

Windows

  • You are an administrator of this PC: The question about the change says so in its last sentence. Right after Switch Account, as soon as the device is signed in to the new account, Windows asks for an administrator: Windows’ User Account Control appears and names DeskRanger; it shows no text of ours. Only then is the background service moved. If User Account Control is switched off on this PC, Windows does not ask and the background service is moved without a prompt. If you cancel the prompt, nothing changes at the background service and no error appears; your change of account in the app stands, the background service stays with the previous account.
  • After the move the service is a new device in the new account: if DeskRanger Secure is on there, a device of the new account has to approve it first. Let my devices connect without asking is off for it: connections from your own devices are asked about at the device. At the lock screen and before sign-in nobody can accept, so no connection comes about there.
  • You are not an administrator: You are not asked for a password. Access before sign-in stays with the previous account, even though you switched in the app. The question tells you: “Access before sign-in stays with the previous account. An administrator of this device can move it.” Until an administrator moves it, only the devices of the previous account can reach it.

iPhone & iPad

This function is coming soon to iPhone & iPad.

The background service's entry in the previous account's device list stays there until you remove it (Remove from My Devices…). Even when the background service does not move, the change you confirmed stands: only the background service stays with the previous account.

Sign-in activity

Under Security › Sign-in activity you see where you're signed in right now, and your sign-ins from the recent past, including the failed ones.

  • Where you're signed in: every browser and app with its approximate location, when it signed in and when it was last active. Sign out signs one of them out, Sign out everywhere else signs out all but the browser or app you're using (marked This device in the apps). An app that was signed out asks you to sign in again next time.
  • Recent sign-ins: every sign-in with its method (such as passkey, or password + authenticator app), the app or browser and the approximate location. Failed ones are a wrong password, a wrong code in the second step, and a sign-in that was declined on one of your devices.

macOS

Settings (⌘,) › Security, below the trusted browsers. The Security tab is there for every signed-in account, with or without DeskRanger Secure. DeskRanger asks only before Sign out everywhere else. A click that comes from a remote session on this Mac is not carried out: signing out works only directly at the Mac.

Security settings › “Sign-in activity”: the signed-in apps and browsers with “Sign out”, and the recent sign-insSecurity settings › “Sign-in activity”: the signed-in apps and browsers with “Sign out”, and the recent sign-ins

Windows

Settings › Security, below the trusted browsers. The Security area is there for every signed-in account, with or without DeskRanger Secure. DeskRanger asks only before Sign out everywhere else. A click that comes from a remote session on this PC is not carried out: signing out works only directly at the PC.

Security settings › “Sign-in activity”: the signed-in apps and browsers with “Sign out”, and the recent sign-insSecurity settings › “Sign-in activity”: the signed-in apps and browsers with “Sign out”, and the recent sign-ins

iPhone & iPad

More › Settings › Security, under the trusted browsers. The Security section is there for every signed-in account, with or without DeskRanger Secure. DeskRanger asks only for Sign out everywhere else before signing out. On the Dashboard, the card for new sign-ins takes you here with a tap.

Web

In the web console on the Security page, below two-factor sign-in and DeskRanger Secure.

Android

Settings › Security, at the very bottom, under the trusted browsers. The Security section exists for every signed-in account, even without DeskRanger Secure. Sign out everywhere else asks first; Sign out does not. On the Dashboard, View on the New sign-in card leads here. DeskRanger asks for the activity when you open the page or the Dashboard, with a pause between requests. Without a connection the page says The sign-in activity couldn't be loaded. with Try Again.

The location is approximate: DeskRanger works it out from the IP address, and on mobile networks or with a VPN it can be far off. DeskRanger keeps the location, the method and the app or browser, not the IP address. Data sources and retention periods are listed in the Privacy Policy.

If you see a sign-in that wasn't you, change your password, choose Sign out everywhere else and turn on two-factor sign-in.

Upgrade and subscription

On Account one line names your plan: Free, or for a paid plan when the subscription renews (Pro – renews on …) or ends (Pro until …). When the last payment is open, the line says Pro – the last payment is outstanding; the paid plan stays active until the payment provider has tried again. After a purchase the line says Your purchase is being processed. A confirmation follows by e-mail. until the account has applied it.

macOS

Next to the line, Free shows Buy Pro … and a paid plan shows Manage subscription …. Both open the subscription page of the web console in your browser; you sign in there, and there you pay or cancel.

Windows

Next to the line, Free shows Buy Pro … and a paid plan shows Manage subscription …. Both open the subscription page of the web console in your browser; you sign in there, and there you pay or cancel.

iPhone & iPad

On iPhone and iPad there is no plan line or purchase button. You manage and cancel your subscription in the web console.

Web

The Account page of the web console leads to the subscription page, where you pay or cancel.

When a connection fails at the limit of your plan, the message names the plan that lifts it and offers Buy Pro. That opens the same subscription page. The app never changes your plan by itself; it applies once the payment has arrived.

Pay for a plan

You buy your plan under Plan and invoices in the web console. If your app offers Buy Pro …, that button opens this page. Payment opens a separate page showing the available payment methods. Your card details do not reach DeskRanger. See Buy and manage a plan.

Delete the account

macOS

Settings (⌘,) › Account › Delete Account…. You confirm with your password; an account without a password is confirmed with Apple, Google or Microsoft (Confirm with Microsoft).

Delete the account permanentlyDelete the account permanently

iPhone & iPad

Under More › Settings, at the bottom: Delete Account….

Delete the account permanentlyDelete the account permanently

Web

In the web console on the Account page. If you signed in with Apple, Google or Microsoft, that sign-in must still be recent.

All devices of the account are deleted with it, and running sessions end. This cannot be undone.

Settings

For your account, Settings has the Account page (confirm your email, your plan, your devices, sign out, delete the account) and the page of this device (its name and device ID). On the Mac and on Android, Settings also lists the system permissions DeskRanger needs and shows how to grant each one. All groups and the search are explained in Settings.

Under the account's devices each computer has one row, even when the app and DeskRanger Host both run on it or DeskRanger was installed there before. The row says what runs there (App and Host, App only, Host only; a Linux computer with only the Host is a Server); iPhones, iPads and Android devices show nothing there. Earlier installations of the same computer that are offline show in its row as an earlier installation. Open the row to see each entry and remove one alone (Remove only this entry); the row's trash removes every entry of the computer after one confirmation that names them. Browsers have their own section, Browsers, one per name; a browser offline for more than 30 days is signed out and no longer listed. The grouping is only what you see: it changes nothing an entry may do.

If DeskRanger cannot remove the stored sign-in on this device while signing out, it shows “Sign-out incomplete – try again” with Try again. Try again: only then is it certain that the sign-in does not come back at the next start. In the browser the same message appears on the sign-in page when DeskRanger could not reach the account service.

On the Mac, on Windows, on iPhone and iPad and on Android, Manage Account… opens your account's page in the browser. You rename a device of your account where you select it: in the menu of its card with Rename…; the new name applies on all your devices.

Under Privacy and info, Open Source Licenses lists the open-source software inside the app with its licence, searchable and with the full licence text of every component. It also credits DB-IP, where the approximate place of a sign-in comes from.

If DeskRanger cannot start

If the app cannot read its own secrets when it starts, it says so on screen and offers Try Again. It never shows made-up demo data instead.

Windows

If Windows can no longer open the keys of this device, for example after the Windows password was changed elsewhere, the app offers Set up again. After you confirm, only the old identity folder with the device's data is moved aside, not deleted; the app's other local files stay. The PC then gets a new identity and you sign in as usual. Things saved only on this PC are gone. With DeskRanger Secure on, another of your devices must approve the PC again.

The PC's old entry then still stands in the device list. The device list shows the hint Old entry of this device with Remove old entry; it removes the entry like any other removal of a device, so with DeskRanger Secure an approving device confirms it. In the network, a PC that can approve keeps its name and address with DeskRanger Secure: the next time it is switched on, it takes its old entry out of the network and joins again with that entry's name and address. You confirm twice with Windows Hello for that. Otherwise it joins as a new device, with a new name and a new address.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Web

In the browser, the browser itself is the device. Its key stays in the browser, but code from the same browser origin (website) can read it; from time to time DeskRanger renews the device's certificate, and the key stays the same. If you clear the browser's data, it counts as a new device on the next sign-in.

Was this helpful?

Checked for version 0.1.0 · as of 2026-10-07