Engee documentation

Working with the Engee offline client

Engee Offline Desktop is a client service designed to work with the Engee platform from a local computer without an internet connection. Engee's functionality in offline mode is fully consistent with its cloud version.

The offline client has access to all versions of the Engee personal account, so you can work with your preferred version in the offline client. The list of available versions is determined by the configuration of the selected master license.

Preparing to launch the offline client

Before you start working in the offline client, download all the files and data you will need offline to the Engee cloud in advance so that you can then load them into the offline client.

Before you start working with the offline client, make sure that your master license administrator has granted the appropriate rights to run the offline version:

  • If the license is issued, the Engee offline mode toggle switch in the upper right corner of your personal account becomes active:

    engee offline 3 en

  • If the license has not been issued, the toggle switch is inactive. Contact your master license administrator.

    Instructions for issuing an offline client in a master license (for administrators)

    When the Engee Offline Desktop product is added to the master license, it is manually assigned and configured by the master license administrator:

    • For one user:

      1. Open the Users tab.

      2. Select the desired user with a check mark.

      3. Click on the ellipsis icon ellipsis icon and select Limits Edit:

        limits edit 1 en

      4. Turn on the switch next to the Engee Offline Desktop product.

        engee offline resources en

    • For a group of users:

      1. Open the tab Profiles.

      2. Turn on the switch next to Engee Offline Desktop for the selected profile (group).

      3. To add or remove users, use the Associations.

    The maximum offline client operation time is 30 days.

The offline client is available on Linux and Windows with WSL (Windows Subsystem for Linux) support. To run the offline client, you need to install a virtualization application, such as VirtualBox (recommended). For further correct operation with the virtualization application:

  • When installing the virtualization application, check the box Run when opening .ova or .ovf files (for VirtualBox on Windows):

    windows installer vm en

  • Ensure that hardware virtualization is enabled in your operating system:

    • For Windows, hardware virtualization is usually enabled by default. If not, see instructions;

    • For Linux, hardware virtualization is enabled by default in all popular distributions.

If you experience low performance or startup errors when starting a virtual machine, you need to disable the kernel isolation feature in Windows security settings:

  1. Open Windows Security → Device Security.

  2. Go to the Core Isolation section.

  3. Switch the Memory Integrity toggle switch to the Off position:

    kernel isolation en

  4. Restart your computer.

Disabling kernel isolation allows VirtualBox to work correctly with hardware virtualization.

You cannot work in both cloud and offline clients at the same time within a single account. Before you start working in the offline client, stop the online session Engee:

engee offline 9 en

Launching the offline client

Switch the Engee toggle to offline mode in the upper right corner of the main page of your personal account:

engee offline 3 en

After switching the toggle, a window for downloading and authorizing the offline client will be added:

engee offline 2 en

Downloading and installing the offline client

Click the Download button to download the .ova file containing the necessary data to start the virtual machine.

windows installer vm 1 en

Importing the configuration takes varying amounts of time depending on the power of your computer. You can track the import process in the virtualization application:

windows installer vm 2 en

Upon completion of the import, the file will automatically create a ready-to-run virtual machine (by default named desktop):

windows installer vm 3 en

After importing, you need to open the settings of the imported virtual machine in the «Settings → System» section:

  • In the «Motherboard» tab, set the amount of RAM to at least 12 GB;

    windows installer vm 4 en

  • In the «Processor» tab, set a minimum of 4CPU.

    windows installer vm 5 en

If the minimum configurations have already been set, then nothing needs to be changed.

Start the virtual machine by clicking the «Start» button in the virtualization application. After installing Engee, the virtual machine console will display the address for further launching the offline client:

windows installer vm 6 en

The Authorize Engee Desktop button in the virtualization application opens this link automatically—there is no need to copy it manually. The appearance of the link in the console means that the virtualization application has worked correctly.

Offline client authorization

After installing the offline client, you need to authorize it. To do this, return to the Engee personal account home page and click the Authorize Engee Desktop button. Alternatively, you can enter the link received in the virtual machine into the browser address bar.

A window will open for logging into Engee Desktop. In the window, enter the domain name from which the offline client .ova file was downloaded. You can enter the domain with or without the http/https protocol. For example, the domain for https://engee.com/account/ can be specified as https://engee.com/account or engee.com/account. After entering the server domain, click Log in with Engee ID:

engee offline 13 en

Then select the version of Engee whose offline client you want to run and wait for it to install:

engee offline 14 enengee offline 15 en

If offline client activation has not been completed but the toggle switch has been switched back, the system will issue a warning:

engee offline 1 en

  • Terminate — exit offline mode

  • Continue — further work in offline mode

After successfully activating the offline client Engee, a simplified version of your personal account will open, from which, as with the online client, you can start a session and begin working:

engee offline 16 en

To return to the cloud version of Engee, click the button in the upper left corner:

engee online 17 en

Before exiting offline mode, don’t forget to export your work from Engee Desktop (e.g., save/download projects and files) so that you can then upload them to Engee Cloud.

In the confirmation window that opens, click Stop and exit Engee Desktop — synchronization and switching to online mode will begin:

engee offline final exit en

During synchronization, do not disconnect from the Engee server or turn off your computer until the process is complete:

engee offline switchback en

You are back online at Engee! You can close the localhost page and virtual machine until the next launch.