Skip to main content

Set Up the Desktop App

The Gravity Rail Manager app lets the Manager work in a web browser on your own computer. Use it for websites that only you can sign in to. You stay signed in to those websites on your computer, and you type your own passwords.

You need:

  • A Mac with macOS 13 (Ventura) or later, or a Windows 11 PC (64-bit).
  • Your Gravity Rail sign-in.
  • About 1 GB of free disk space.

1. Install the app​

On a Mac:

The Mac download is not available yet. Your administrator will provide the installer after the signed release is published. Once you receive it:

  1. Save Gravity-Rail-Manager.dmg to your Mac.
  2. Open the downloaded file, Gravity-Rail-Manager.dmg.
  3. Drag Gravity Rail Manager into the Applications folder.
  4. Open Applications and double-click Gravity Rail Manager.
  5. If your Mac asks whether you want to open an app downloaded from the internet, click Open.

On Windows:

  1. Download Gravity-Rail-Manager-Setup.exe to your PC.

    To check the file first (optional): open your Downloads folder in File Explorer, type powershell in the address bar and press Enter. Run Get-FileHash Gravity-Rail-Manager-Setup.exe. Compare its Hash with the 64-character value at the start of Gravity-Rail-Manager-Setup.exe.sha256; ignore the file name after it. Upper or lower case does not matter. If they do not match, do not run the file.

  2. Double-click it. The app installs for your Windows account only; you do not need administrator rights.

  3. Windows shows Windows protected your PC, because the installer is not signed yet. The publisher shows as Unknown publisher. Click More info, then Run anyway, only for a file you downloaded yourself from the link in step 1. If you got the file any other way (email, chat or another website), do not run it.

  4. Open Gravity Rail Manager from the Start menu.

2. Sign in​

  1. The first time you open the app on a computer, read the agreement, tick I agree, and click Continue. You agree that you are responsible for making sure this computer is suitable for the data you work with.
  2. Click Log In with Gravity Rail. Your usual web browser opens.
  3. Sign in the way you always do. When the page says you can close the window, go back to the app.
  4. Gravity Rail opens by itself. If it shows Could not open Gravity Rail in the app. Try again, or quit and reopen the app., click Try again.

The app keeps you signed in. You may need to sign in again after about a month without opening it, after Connection → Log out, or when Gravity Rail cannot renew your session. The app then returns to Log in.

The first time you open the app, it downloads its own browser in the background (about 200 MB). This takes a few minutes on a slow connection.

3. Turn on the Web Browser​

  1. Open the Manager, and start a new Chat.
  2. Click the Computer button next to the message box.
  3. Turn on Web browser.

4. Ask the Manager to use a website​

Ask for what you need, for example: "Open example.com and tell me what the page says."

The first time the Manager uses a browser in a Chat, it asks you to choose:

  • Local browser — a browser window on your computer. Choose this for websites you sign in to yourself.
  • Cloud browser — a browser on Gravity Rail's servers.

Choose Local browser. A browser window called Google Chrome for Testing opens on your computer. This is the app's own browser. It is separate from your normal Chrome, Safari or Edge, and it does not share their passwords or history.

The local browser opens public websites. Internal addresses such as an intranet, .local names and localhost are blocked.

While the browser is open, the Web browser row in the Chat's tools sidebar shows a live picture of the page; open that row if it is collapsed. Click the picture to bring the browser window forward.

The Chat remembers your choice. You do not have to choose again in that Chat.

5. Sign in to a website yourself​

When a website needs your password or a verification code, the Manager stops and shows Take over the browser. The browser window comes to the front.

  1. Type your password, code, or answer in the browser window.
  2. Go back to the Chat and click Return control. The Manager continues.

If you do not want to do the step, click Continue without takeover.

The Manager never types passwords. It always hands password fields to you.

Your sign-in is saved for that Chat. Next time, continue in the same Chat and you usually stay signed in. A new Chat starts with a fresh browser that is not signed in to anything.

Allow browser work while the Chat is closed​

Background browser access starts off. To allow it, open Settings → Background browser, choose a workspace, and turn on Allow background browser access. Your Member needs workspace admin and Chat read access. The workspace must have the Web Browser feature.

While the app is running and signed in, Manager can use a separate browser on this computer for approved work in your private Manager Chat, even after you close the Chat. Each Chat gets its own browser profile. Turn the switch off to disconnect the background browser and stop pending browser work. Signing out or switching workspaces also removes permission. If an admin restores access after a denial, turn the switch off and on to reconnect.

Updates​

The Mac app updates itself. When an update is ready, it asks you to restart. Click Restart now, or Later to finish what you are doing first. The Windows app does not update itself yet: to update it, download Gravity-Rail-Manager-Setup.exe again and run it.

Troubleshooting​

What you seeWhat to do
Your Gravity Rail sign-in has ended. Log in again.Click Log In with Gravity Rail and sign in as usual. If it happens again the same day, contact support.
Could not reach Gravity Rail. Check your internet connection and try again.Check your connection, then click Try again.
Gravity Rail could not complete sign-in. Update the app and try again.Install the latest Gravity Rail Manager, then reopen it. On Windows, download Gravity-Rail-Manager-Setup.exe again. On a Mac, ask your administrator. If it repeats, contact support.
Could not open Gravity Rail in the app. Try again, or quit and reopen the app.Click Try again. If it repeats, quit and reopen the app.
Local browser is not offered, or "The local browser is not connected"Make sure you opened Gravity Rail from the Gravity Rail Manager app, not from your web browser.
A browser step says it did not run because no browser was chosenAsk the Manager again. Choose Local browser to use the browser on this computer, or Cloud browser to use the shared one.
"Could not download the local browser"Check your internet connection, then ask the Manager again.
"Could not install the local browser"Check free disk space, then ask the Manager again.
Could not prepare local browser storage…Check free disk space and app-folder permissions with your administrator, then try again. Other app features remain available.
An internal website is blockedUse a public website address. Ask your administrator for an approved way to use the internal system.
The browser window is hiddenOpen Web browser at the top of the Chat, then click the picture of the page. The browser window comes forward.
You are asked to sign in to the app every daySign out (Connection → Log out) and sign in again. If it continues, contact support.
You want to sign out of a websiteIn the browser preview menu, choose Clear cookies and site data.

Privacy​

Website sign-in state and cached pages stay in the app’s private browser profile on your computer. The app does not encrypt them. You are responsible for keeping this computer suitable for the data you work with, as you agreed when you first opened the app.

  • The local browser runs on your computer. The websites you open see your computer's internet connection, as with any browser you use.
  • Pages the Manager reads, and screenshots it takes, are saved to your Gravity Rail workspace like other Chat content. The live thumbnail of the local browser is not: those frames stay in the app's memory on your computer and are never uploaded.
  • Downloads from the local browser are saved into the Chat's files.