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.
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
- Choose the device in Devices.
- Click Connect. The session opens in a window of its own.
- When you are done, click End in the toolbar.


Windows
- Choose the device in Devices.
- Click Connect. The session opens in a window of its own.
- When you are done, click End in the toolbar.
iPhone & iPad
- In the device list, tap Connect next to the device.
- When you are done: End session.


Web
- Open the devices in the web console and click Connect on the device.
- 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.


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.


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….
Sidebar: collections, groups and library
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.


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.




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.




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.


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.




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.








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.










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.




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.


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.


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.


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.


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.


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.




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
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.
Your own device does not reach DeskRanger. Check that it is online, then try again. The other device is not the problem here.
The person at the other device declined or did not respond in time. Try again when someone is at the device.
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).
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).
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.
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.
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.