Help › Getting started

Connect to one of your devices

Open the screen of one of your devices as if you were sitting in front of it. Whether your device asks depends on its settings and on whether you connect from an app or a browser.

FreemacOSWindowsiPhone & iPad · Coming soonWebAndroidLinux

Both devices must be signed in with the same account. On the Mac you want to reach, Allow connections to this Mac must be on (in the bubble of the This Mac field at the bottom of the sidebar, and in Settings).

On Windows the field is called This PC: Allow connections to this PC is in its bubble and under Settings › This PC.

macOS

  1. Choose the device in Devices.
  2. Click Connect. The session opens in a window of its own.
  3. When you are done, click End in the toolbar.
The device list with the Connect buttonThe device list with the Connect button

Windows

  1. Choose the device in Devices.
  2. Click Connect. The session opens in a window of its own.
  3. When you are done, click End in the toolbar.

iPhone & iPad

  1. In the device list, tap Connect next to the device.
  2. When you are done: End session.
The device list with the Connect buttonThe device list with the Connect button

Web

  1. Open the devices in the web console and click Connect on the device.
  2. From a browser, DeskRanger asks: someone at the other device has to allow the request. The exception is one of your own computers that allows access without a click at the device from the browser with DeskRanger Secure – then you approve the session on another of your devices. The request there says it comes from a browser (Browser “…” · in your account), whatever the browser is called.
The device list with the Connect buttonThe device list with the Connect button

While you wait for the other device

macOS

After you click Connect, someone at the other device has to accept first. Until then a bar at the bottom says “Waiting for someone at (device name) to accept …” with Cancel. Cancel ends the request at once; the other device then shows no question any more. For a connection with a support code the bar says “Waiting for confirmation …”, because the other computer's name is not known yet.

iPhone & iPad

After you click Connect, someone at the other device has to accept first. Until then a bar at the bottom says “Waiting for someone at (device name) to accept …” with Cancel. Cancel ends the request at once; the other device then shows no question any more. For a connection with a support code the bar says “Waiting for confirmation …”, because the other computer's name is not known yet.

Your devices at a glance

Every card shows what the device is and what a session offers:

  • The icon stands for the kind of device: desktop, laptop, phone, tablet, server or NAS, a browser, a remote desktop or an SSH host. The device reports it itself. If it is wrong, choose the right type on the Mac, in Windows, on Android or in the web console in the card's menu under Device Type; Automatic (…) goes back to what the device reports. The choice applies to every device of your account.
  • The picture is the last frame of your last session from here, with Last session · …. It stays on this device and is never uploaded; it goes after a limited retention period, with the device and when you sign out. Without a session the card shows the system's controls: windows, taskbar or home screen. A device that is asleep or offline is dimmed.
  • The small icons show what works: Screen and control, View only, Send files, Terminal, Network and Unattended. Point at one to see the word; on a phone the words are in the device's information. If there are more than four, “+1” shows the rest.
  • Last in a Session tells you when one of your devices was last connected to this one, and which, for example “2 hours ago · from BV9300”. DeskRanger knows this from your account's session data – when and between which devices, never the content. When you last connected from here is in the hint next to it.
  • A small lock next to the system on the picture means: after a restart the device waits until someone enters the FileVault password, the BitLocker PIN or a Linux computer’s disk password on site. Hover over it and it says so. Only your device knows this, from the other device’s device information – never our server.
  • The status names the path and the response time only when DeskRanger has just measured them. Otherwise it shows an estimate, for example Online · direct possible. Between two devices on the same network it says relay only after repeated measurements found no direct path: the first seconds of a connection are the search for one.
  • After a restart the card says Restarting…. If the device then waits for someone on site, after a waiting period it says Waiting for FileVault, Waiting for BitLocker PIN or Waiting for disk password, with “probably” and the time on the picture. After a shutdown it says since when it has been off.
  • From there only marks devices that can connect to your devices but that you cannot connect to: an Android phone that does not allow connections, an iPhone that is not sharing right now, a browser, or a computer that is not accepting connections right now. The hint says why. An Android phone says Connect (view and control) while its remote control is on there, and View otherwise; an iPhone or iPad can only be viewed.
  • Asleep marks an Android device of your account that allows connections but is asleep in the background right now. When you connect, DeskRanger wakes it, and after a few seconds things go on as usual. If it is off or has no network, DeskRanger says after a short while that it is offline.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Web

The web console shows the same cards. Sessions in the browser come with Pro: on a Free plan Connect carries a small “Pro”, and a click explains it and offers Buy Pro. A running session never ends because of a plan change. A browser always connects through a relay, never directly: a device that is online therefore says Online · relay only. The last frame of a session stays in this browser and is never uploaded; it goes when you sign out, after a limited retention period and when you remove the device. Above the list, Sorted by: … sorts by status, name or recently connected.

The devices in the web console: a session's last frame, device type, “Online · relay only”, features and “Only from there”The devices in the web console: a session's last frame, device type, “Online · relay only”, features and “Only from there”

Above the list: filter, sort, grid or list

iPhone & iPad

This function is coming soon to iPhone & iPad.

Linux

Under the page title are filters by status: every device on the page, then those that are Online, Asleep or Offline, each with its number. The numbers count what the search has not narrowed yet. When the page holds several kinds (devices and remote desktops, say), the filters by kind follow after a divider; a second click on the chosen filter lets it go. To the right of the filters, Sorted by: … opens the sorting: recently connected, name or status, and for favourites also your order; Recently Connected has no choice, it always shows the newest first.

In the header bar, the pair of grid and list icons (as Grid, as List) switches between cards and a table with the columns Name, Status, Features, Group, Last in a Session and the button to connect. In a narrow window the group goes first, then the last session, then the features. DeskRanger remembers your choice. A double click on a row connects. While a session with a device already runs, a green Connected stands in place of Connect; a click on it brings the session's window forward. The help icon Support Code next to it opens a menu with Enter Support Code… and Get Help….

iPhone & iPad

This function is coming soon to iPhone & iPad.

Android

The phone has no sidebar, so the collections are tabs under the top bar: Dashboard (the start page, with a number while something is waiting for you), Devices, Favorites, Recently Connected, Shared with Me, and then each of your groups with its icon in its color. Swipe the row to reach them all. Kind filters and the sections by place work as described below; the status filters stay under the search.

Tap Sidebar (the three lines at the top left) to open the drawer. It has the same rows with their counters (Dashboard at the top, Devices as the first row of the Library), then Groups with Create a New Group and a ⋮ menu on every group (Rename, Color, Icon, Move Up and Move Down, Delete Group…), then Library with Terminal. Tap the heading of Groups or Library to fold it. Customize Sidebar… at the end of Library hides rows of the library. The library offers Files, Network and Terminal.

Icon in a group's menu opens a grid of icons. A new group asks for its name and icon right away.

A group's “Icon” picker: 32 icons in a grid, the office building of the group “Office” is chosenA group's “Icon” picker: 32 icons in a grid, the office building of the group “Office” is chosen

On Favorites, open a card's ⋮ menu and choose Move Earlier or Move Later to change the order. DeskRanger opens the tab you used last when you start it again. Hidden rows, folded sections, the last tab and the order apply on this phone only, not in the account.

“Favorites” with devices, a remote desktop and SSH hosts, chips by kind and a section per place“Favorites” with devices, a remote desktop and SSH hosts, chips by kind and a section per place
“Customize Sidebar” on the phone: the switch for Terminal; the groups and collections always stay“Customize Sidebar” on the phone: the switch for Terminal; the groups and collections always stay

The sidebar is laid out like this, from top to bottom:

  • Devices shows your devices and your remote desktops. SSH hosts are under Terminal.
  • Favorites, Recently Connected and Shared with Me collect everything you use, whatever kind it is: devices, remote desktops and SSH hosts. Filters above the list filter by kind, for example Remote Desktop · … or SSH · …. There are filters only for kinds that are there.
  • Groups come right below. A group holds the devices, remote desktops and SSH hosts you put into it yourself.
  • Library sorts by kind: Files, Network and last Terminal with the Port forwards tab for running SSH forwards. Network shows what this device serves as a gateway for, and which tunnels run through it right now.

macOS

On the Mac, Dashboard is at the very top, above the collections: the start page, with a number while something is waiting for you. Devices is the first row of the Library instead and stays when you collapse the Library with the arrow at its heading.

Windows

On Windows, Dashboard is at the very top, above the collections: the start page, with a number while something is waiting for you; Ctrl+0 opens it. Devices is the first row of the Library instead and stays when you collapse the Library with the arrow at its heading. What you hid in the sidebar or opened last stays as it was.

iPhone & iPad

This function is coming soon to iPhone & iPad.

Linux

On Linux you create a group in the menu of a device card: Add to Group, then New Group…. A window asks for the name and the Color; the name is filled in with New Group, and Cancel creates nothing. Right-click a group in the sidebar (or press the Menu key) and choose Rename for its name and color, or Delete Group…; the devices in it stay in your library.

Every group wears an icon in its color. Right-click a group and choose Color or Icon; Icon opens a picker, for example a house for Home or a server for Server. A new group starts with Folder. Color and icon apply on all your devices; an icon that a newer DeskRanger knows and this one does not yet shows as Folder.

The sidebar with the groups “Home”, “Office” and “Parents”: each wears its icon in its colorThe sidebar with the groups “Home”, “Office” and “Parents”: each wears its icon in its color
A group's “Icon” picker: 32 icons in a grid, the office building of the group “Office” is chosenA group's “Icon” picker: 32 icons in a grid, the office building of the group “Office” is chosen

iPhone & iPad

This function is coming soon to iPhone & iPad.

Web

In the web console you choose the icon under Manage groups: when you create or edit a group, Icon sits next to Color. The icon wears the group's color in the sidebar, on the group's page and in the lists. A group you create from a device card's menu under Groups… starts with Folder; you change its icon afterwards under Manage groups.

Manage groups in the web console: the “Icon” picker next to the color while editing a groupManage groups in the web console: the “Icon” picker next to the color while editing a group

You choose the order of your Favorites yourself: drag a card in front of another, or choose Move Earlier or Move Later in the card's menu. For now the order applies on this device only.

Right-click the sidebar and choose Customize Sidebar… to hide rows of the library. Devices, the collections and your groups always stay. Groups and Library can be collapsed. At the next start, DeskRanger opens the page you chose last. These settings apply on this device only, not in the account.

“Favorites” with devices, a remote desktop and SSH hosts, chips by kind and a section per place“Favorites” with devices, a remote desktop and SSH hosts, chips by kind and a section per place
“Customize Sidebar”: Network and Terminal shown, Files hidden“Customize Sidebar”: Network and Terminal shown, Files hidden

iPhone & iPad

On the iPad the sidebar sits on the left, with the same collections, groups and library; Dashboard, the start page, is at the very top, with a number while something is waiting for you. Devices is the first row of the Library and stays when you collapse the Library. The iPhone has no sidebar: there the Dashboard and the collections are a row of segments under the title of Devices, see below.

iPad

  • Press and hold a group to choose Rename, Color, Icon or Delete Group…. The plus next to Groups creates a new group.
  • You change the order of Favorites in the card's menu (press and hold): Move Earlier or Move Later. For now the order applies on this iPad only.
  • Tap the icon with the sliders at the top of the sidebar to open Customize Sidebar…. Pressing and holding a row shows it too.
  • On the iPad the library shows only what the iPad can do: Files, Network and Terminal. An iPad never serves as a gateway for other devices, and the Network page says so. There is no Port forwards tab on the iPad.
“Favorites” with devices, a remote desktop and SSH hosts, chips by kind and a section per place“Favorites” with devices, a remote desktop and SSH hosts, chips by kind and a section per place
The sidebar with the groups “Home”, “Office” and “Parents”: each wears its icon in its colorThe sidebar with the groups “Home”, “Office” and “Parents”: each wears its icon in its color
A group's “Icon” picker: 32 icons in a grid, the office building of the group “Office” is chosenA group's “Icon” picker: 32 icons in a grid, the office building of the group “Office” is chosen
“Customize Sidebar”: Network and Terminal shown, Files hidden“Customize Sidebar”: Network and Terminal shown, Files hidden

iPhone

Under the title of Devices there is a row of segments: Dashboard (the start page), Devices, Favorites, Recently Connected, Shared with Me, and then each of your groups with its icon in its color. Swipe the row to reach them all; tap a segment to change the page. Kind filters and the sections by place work as described above.

  • Press and hold a group to choose Rename, Color, Icon or Delete Group…. Icon opens a choice of icons. The plus at the end of the row creates a new group; there you choose its name, color and icon right away.
  • You change the order of Favorites in the card's menu (press and hold): Move Earlier or Move Later. For now the order applies on this iPhone only.
  • Open Network from the bottom bar; Terminal is under More. The sliders at the end of the row open Customize View…. The collections, your groups and Settings always stay.
  • DeskRanger opens the segment you chose last when you start it again. Hidden tabs and the order of the favorites apply on this iPhone only, not in the account. An iPhone never serves as a gateway for other devices, and Network says so.
“Favorites” on the iPhone: the segments on top, below them chips by kind and cards with devices, a remote desktop and SSH hosts“Favorites” on the iPhone: the segments on top, below them chips by kind and cards with devices, a remote desktop and SSH hosts
The segments on the iPhone: “Home”, “Office” and “Parents” wear their icon in their color, “Office” is chosenThe segments on the iPhone: “Home”, “Office” and “Parents” wear their icon in their color, “Office” is chosen
A new group on the iPhone: name, color and a grid of iconsA new group on the iPhone: name, color and a grid of icons
A group's “Icon” picker on the iPhone: a grid of icons, the office building of the group “Office” is chosenA group's “Icon” picker on the iPhone: a grid of icons, the office building of the group “Office” is chosen
“Customize View” on the iPhone: the switches for Terminal and Network; the collections, groups and account always stay“Customize View” on the iPhone: the switches for Terminal and Network; the collections, groups and account always stay

Web

In the web console the sidebar sits on the left, behind Menu on small screens. Devices is the first row of the Library and stays when you collapse it. The library shows only what the console really offers: Network (its page says that tunnels are set up in the apps) and Terminal. Apps, files and passwords are missing because a browser does not open another device's windows, has no file manager and never opens a vault; Customize Sidebar… lists the same rows. Your saved remote desktops appear under Devices in a section of their own below the devices (see Connect to a Windows PC with Remote Desktop); the web console does not show SSH hosts yet, so there are no chips by kind for now. Chips above the list filter by status: all, online and offline.

Customize Sidebar… sits below the sidebar and in the sidebar's right-click menu. You collapse Groups and Library by their heading. You change the order of your Favorites in the card's menu with Move Earlier and Move Later, or by dragging the card, as long as sorting is set to your order. The console opens on the page you chose last.

Only this browser remembers all of this, not your account. The order of the favorites applies per account in this browser and is gone after you sign out.

The web console's sidebar: Devices, Favorites, Recently Connected and Shared with Me, below them the groups with their icons and the library with NetworkThe web console's sidebar: Devices, Favorites, Recently Connected and Shared with Me, below them the groups with their icons and the library with Network
“Customize Sidebar” in the web console: the Network row can be hidden and shown“Customize Sidebar” in the web console: the Network row can be hidden and shown

Connections: everything that is open right now

Next to search, the Connections icon shows what is open right now, and its number shows how many connections are running. If nothing is open, the icon is gone. If there is only a terminal that keeps running without you, the icon shows no number. A click opens the list in three groups:

  • On this device: what this device views, types into or transfers, so screen sessions, terminals, SSH, remote desktops, forwards and running file transfers. Open jumps back to the window or tab, End ends the connection. A terminal nobody is connected to any more is listed with “keeps running, nobody connected” and Reconnect. If you end it, DeskRanger asks first, because work in the shell can be lost.
  • Connected to me: who is on this device right now. Here, too, you can choose End.
  • More in the account: the other sessions of your account. They can only be ended on their own devices. The detailed list with the limits of your plan is further down under Account.

The list shows names and devices only, never content.

The “Connections” list: on this device a screen session, SSH with a forward, a transfer and a detached terminal, plus who is connected to this device and one more session in the accountThe “Connections” list: on this device a screen session, SSH with a forward, a transfer and a detached terminal, plus who is connected to this device and one more session in the account

iPhone & iPad

On the iPad the icon sits next to the search, on every page of the sidebar. Open takes you back to the session, the terminal or Network. A group appears only when something is listed in it.

The “Connections” list: on this device a screen session, SSH with a forward, a transfer and a detached terminal, plus who is connected to this device and one more session in the accountThe “Connections” list: on this device a screen session, SSH with a forward, a transfer and a detached terminal, plus who is connected to this device and one more session in the account

On the iPhone the icon sits in the title bar of Devices, Terminal and Network, next to the search and the plus. The list opens from the bottom; drag it up when it is longer, and tap Done to close it. Open brings the session or the terminal to the front. The Connected to me group is not shown here. You can share your iPhone’s screen through screen broadcasting.

The “Connections” list on the iPhone, opened from the bottom: on this device a screen session, SSH with a forward, a transfer and a detached terminal, plus one more session in the accountThe “Connections” list on the iPhone, opened from the bottom: on this device a screen session, SSH with a forward, a transfer and a detached terminal, plus one more session in the account

Web

In the web console the Connections icon sits at the top, in the header next to appearance and language. It shows only two groups: On this device are the sessions this browser has open in its tabs, More in the account the other sessions of your account. Nobody can view a browser, so there is no “Connected to me”. Open jumps to the session; if it is open in another tab, the session page offers Continue Here. End ends the session in its tab. The console only shows your account's sessions; they can be ended on their own devices.

The “Connections” list in the web console: on this device one session of this browser with “Open” and “End”, plus more sessions in the accountThe “Connections” list in the web console: on this device one session of this browser with “Open” and “End”, plus more sessions in the account

Android

On the phone the icon sits in the top bar, next to the switch between grid and list. The list opens from the bottom of the screen. Open brings the terminal tab or the session back to the front; a transfer opens the session it runs in. Connected to me fills while someone views this phone.

The “Connections” list: on this device a screen session, SSH with a forward, a transfer and a detached terminal, plus who is connected to this device and one more session in the accountThe “Connections” list: on this device a screen session, SSH with a forward, a transfer and a detached terminal, plus who is connected to this device and one more session in the account

How the picture fits your window

In a session you choose how the other screen fits your window; DeskRanger remembers the choice for each device.

  • Match Window: The other device sets its resolution to your window. This is the sharpest picture. After the session, also when the connection drops and does not come back, it gets its own resolution back.
  • Fit to Window: The whole screen in the window. When the size is just above an even step (the same size, twice or half the size), DeskRanger takes that step and leaves a narrow border: text stays sharp.
  • Actual Size: One point there is one point here; when the screen is larger than your window, you move the picture.

If you have not chosen anything for a device yet, a session with your own devices starts with Match Window, others with Fit to Window. If someone may be working at the other Mac's own screen and the Mac does not allow changing it, it quietly stays with Fit to Window.

When the picture rests, text gets crisp: DeskRanger sends the resting parts once more, without loss, after the video picture. When something changes there, that part shows the video again until it rests once more. This applies when you watch on a Mac, iPhone, iPad, Windows PC, Linux computer, Android device or in the browser and the other device is a Mac, a Windows PC or a Linux computer; the other devices follow.

What the other Mac shows

During a session the Mac shows a red frame around the screen and a red indicator with name and duration in the menu bar. From there you can pause or End session. ⌃⌥⌘ Esc ends it at once.

The Mac during a session: red menu bar indicator and red frameThe Mac during a session: red menu bar indicator and red frame
Settings “This Mac” with the switches for connectionsSettings “This Mac” with the switches for connections

When someone signs in or out at the other device

If the device is set up with Reachable before login and while the screen is locked, your session continues when someone signs in, signs out or switches users there. While the session is handed over, the last picture stays and a short note at the top says Signing in – the session continues in a moment … or Logged out – the session is being handed to the login screen …. Shortly after, it continues by itself; clicks and keys wait until then. You see the same when you are at the other device’s login screen and DeskRanger’s helper there is gone for just a moment: a calm wait, never “not answering”. If the other device itself takes longer, for example while a Mac signs in, DeskRanger waits for it: for a limited time; after a sign-in it asks every second at first, then less and less often. For your own unattended session it also finds the device again directly, even when our server is not answering right now. If the device goes away without saying why – for example because DeskRanger is being updated, restarted or switched off there – the note says instead that it is not answering right now and that DeskRanger keeps trying; that, too, applies only for a limited time. If the device is not back by then, the session ends and the window says that the device is offline. If the device announced a restart or a shutdown before, it ends at once.

If it doesn’t work

“The device can't be reached right now.”

Your device reaches DeskRanger, but the other device does not answer: it is offline, asleep, DeskRanger is switched off there, or it is restarting, for example after an update. Your Internet connection is not the cause then. Try again after a moment; the device's card shows whether it is online again.

“DeskRanger can't reach its service. Check your internet connection.”

Your own device does not reach DeskRanger. Check that it is online, then try again. The other device is not the problem here.

“The request was declined or not allowed in time.”

The person at the other device declined or did not respond in time. Try again when someone is at the device.

“Nobody can accept the request there right now: DeskRanger isn’t open on that device, or it’s locked or nobody is signed in.”

Nobody at the other device can accept right now. Usually DeskRanger isn’t open there – the device is only reachable through its background service –, or the screen is locked or nobody is signed in. Ask the person there to open DeskRanger. To have that happen by itself after signing in, they turn on Open at login in Settings under General (see Install DeskRanger).

“Waiting for FileVault”

The Mac announced a restart and has been offline since. It is probably waiting at the FileVault screen until someone enters the password there – we cannot know for sure, it might also be switched off. Ask someone on site to enter the password; the Mac is back after starting up. If Remote Login is on, this also works over SSH from the same network (see Install DeskRanger).

“Waiting for BitLocker PIN”

The PC announced a restart and has been offline since. It is probably waiting for the PIN at the BitLocker screen. Ask someone on site to enter it. If your device does not know whether the device waits for anyone, later it only says since when it has been offline.

“Waiting for disk password”

The Linux computer announced a restart and has been offline since. It probably asks for the disk password (LUKS) at start. Ask someone on site to enter it. If a TPM chip or a Tang server on the network opens the disk, it does not wait and shows no lock.

“Another of your devices is already connected. Your plan connects from one device at a time – end the session there first. With Team, several devices can connect at once.”

The message and plan overview show which limit applies. End the session on the other device first.

When the card says “screen not available right now”

DeskRanger checks by itself on each of your devices whether it can show a screen right now. If it cannot, the card and the list say: “‹Device›'s screen is not available right now:” and the reason, for example that a permission is missing, there is no display, or an update is being installed. The device is online; only its screen is missing. The note appears only when the check is of the device's current build and goes away by itself as soon as the device can show a screen again. On a computer with DeskRanger Host the Host's check counts. If the device offers a terminal, you can open it from the note and look around there. Only fixed causes leave your device with the check, never names, paths, window contents or pictures (see the privacy policy).

Good to know about your device list

  • One card per computer. The app and the background service of the same computer appear as one card, and your plan counts computers, not entries.
  • Version. A card can show which version and build the device runs. When it is older than yours, it says so quietly.
  • Reachable or not. DeskRanger estimates whether a device can be reached from what the device last reported and whether it is on the same network as you. When you last connected is only a hint.
  • Favorites and groups. The star (Add to Favorites) and your groups belong to the account, so they look the same on all your devices. Groups: New Group…, Rename, Delete Group…; one device can be in several groups.
  • After sleep or a network change DeskRanger reconnects by itself, and your lists are refreshed after a successful sign-in. We do not promise a fixed time. If loading the device list fails, DeskRanger tries again with increasing delays until it works.
  • Connecting back. If the device you want to connect to is viewing this computer right now, connecting back would show a mirror image of your own screen. DeskRanger asks first; Connect Anyway goes on anyway. The browser does not have this question.
  • Faster first picture. While the other device still shows its question, it already prepares the picture. Nothing is captured or sent before someone accepts.
Was this helpful?

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