Crystal Cloud for Chromebook

Install the Chromebook Crystal Cloud shortcut.

This setup uses Chromebook Linux and FreeRDP instead of the Windows installer. It adds all 30 Crystal profiles, shows a simple login picker, and writes a log if the connection closes.

Current tested download: CrystalCloud-Chromebook-FreeRDP-20260805-6.zip

Before you start

Use this only on a Chromebook with Linux turned on.

Linux is a normal Chromebook setting. It is not Developer Mode and it should not erase anything. The first setup may take about 10 minutes.

Use the current ZIP.

The file name must say CrystalCloud-Chromebook-FreeRDP-20260805-6.zip. If you already downloaded an older 20260727, 20260728, 20260729, 20260730, 20260731, 20260732, 20260733, 20260734, 20260735, 20260736, 20260737, 20260805, 20260805-2, 20260805-3, 20260805-4, or 20260805-5 file, delete that ZIP and any old extracted CrystalCloud or CrystalCloud-Chromebook folder first.

Keep the Chromebook online.

The installer downloads the remote-desktop tool it needs and automatically uses the version available for that Chromebook.

Use Terminal for setup.

This version is a ZIP with a setup command, not a Debian package.

Passwords are not in the ZIP.

The first time a login is used, enter the Crystal password. The launcher tries to save it on that Chromebook for next time.

One-time Chromebook step

Turn on Linux.

Only do this once per Chromebook.

  1. 1

    Click the time.

    Click the clock area in the bottom-right corner of the Chromebook screen.

  2. 2

    Open Settings.

    Click the gear icon, then choose About ChromeOS on the left.

  3. 3

    Choose Developers.

    Click Developers. Find Linux development environment.

  4. 4

    Click Set up.

    Click Set up, then keep clicking Next or Install. Leave the suggested disk size alone unless Lakeview gave you a different instruction.

  5. 5

    Wait for Terminal to open.

    Linux is ready when a window named Terminal opens. Close it for now.

Install Crystal Cloud

Download, move, and run one command.

Download Chromebook Setup
  1. 1

    Download the ZIP file.

    Click Download Chromebook Setup. It goes into the Chromebook Downloads folder. The file name must be CrystalCloud-Chromebook-FreeRDP-20260805-6.zip.

  2. 2

    Extract the ZIP file.

    Open the Files app, open Downloads, then double-click CrystalCloud-Chromebook-FreeRDP-20260805-6.zip. Choose Extract all. You should now see one folder named CrystalCloud.

  3. 3

    Move the CrystalCloud folder into Linux files.

    Drag the extracted CrystalCloud folder into Linux files on the left side of the Files app. Do not move only the install file.

  4. 4

    Open Terminal inside that folder.

    In the Files app, right-click the CrystalCloud folder and choose Open in Terminal.

    If that choice is not there, open Terminal normally, type the short command below, then press Enter.

    cd CrystalCloud
  5. 5

    Run the setup command.

    Type the short line below, then press Enter. Do not type a file path.

    bash install.sh
  6. 6

    Let setup finish.

    Keep Terminal open. It installs FreeRDP, copies all 30 Crystal profiles, creates the Crystal Cloud shortcut, and opens the login picker. Setup is done when Terminal says Crystal Cloud is installed and asks you to press Enter to close. After that, the original extracted folder is no longer needed.

Everyday use

Open Crystal Cloud and choose your assigned login.

Use only the login assigned to you. Using someone else's active login can interrupt their work.

  1. 1

    Open the Launcher.

    Click the round Launcher button and search for Crystal Cloud.

  2. 2

    Choose the login.

    Select your assigned Crystal login from the picker. The list includes login 1 through login 30.

  3. 3

    Enter the password if asked.

    The first time a login is used, type the Crystal password. The launcher tries to save it in the Chromebook Linux keyring so it does not ask again next time.

  4. 4

    Connect.

    FreeRDP opens Crystal Cloud using the server, gateway, and login settings from the selected profile. If the server times out an inactive session, Crystal Cloud cleans up the closed connection and shows Reconnect or Close. Choose Reconnect to return to the login list right away. If a different recovery message appears and a remote-desktop window is visible, choose Cancel and use that window. If no remote-desktop window is visible, use the recovery button shown: End old session and continue or End stuck launch and try again. If a certificate prompt appears, approve it only when it is for Crystal Cloud.

If it closes

Send the log instead of guessing.

This version writes a log every time Crystal Cloud opens. If the window launches and then closes, the app now shows an error window and the log should show whether the problem is password, gateway, certificate, profile settings, or Linux setup.

Profile folder error fixed.

This version uses Chromebook-compatible folder paths inside the ZIP, then installs the 30 profiles in one fixed location. It also has a backup copy inside the installer.

After the Chromebook was restarted

Open Crystal Cloud once, then give Linux up to 90 seconds to finish starting. Do not keep clicking the app. This version clears an incomplete old launch automatically; if the login list still does not appear after 90 seconds, open Crystal Cloud one more time.

The session timed out because of inactivity

Crystal Cloud has already removed the closed connection. Choose Reconnect to go back to the login list, then choose your assigned login again. Choose Close if you are done; it is safe to open Crystal Cloud later.

It says a previous session is still closing

If the old remote-desktop window is gone, choose End old session and continue. If it is still visible, choose Cancel so that active session is not interrupted.

It says Crystal Cloud is already opening

Use the Crystal Cloud window that is already opening. If no remote-desktop window is visible and it has been loading for more than one minute, choose End stuck launch and try again. That ends only the frozen local launch and starts one clean replacement.

The gateway rejected the login

Choose Replace saved password, then enter the current Crystal password. The app removes the rejected saved password first, so it will not keep retrying the same one.

Terminal cannot find the file

Make sure the extracted CrystalCloud folder was moved into Linux files, not just the install file. Right-click that folder, choose Open in Terminal, then type bash install.sh.

It asks for the password again

The Chromebook could not save the password in its Linux keyring. You can still connect, but it may ask again until the keyring is working.

No Linux option

That Chromebook may not support the Linux environment needed for this setup. Use a Windows computer or contact Lakeview before trying another remote-desktop app.

Ready to try the reliable build?

Download the current Chromebook setup.

Extract the ZIP, move the folder into Linux files, and run the setup command.