Hexagon GeoCloud desktop app FAQ

This page contains frequently asked questions about the Hexagon GeoCloud desktop app, which synchronises data between the cloud storage and your local file system via the Windows File Explorer.

I cannot move folders within a project using the File Explorer

Problem

The GeoCloud desktop app does not currently support moving folders within a project. It will revert the move and display an error on its UI.

Solution

Until the GeoCloud desktop app supports the "Move" functionality, folders need to be moved manually within the project in the following way:

Copy the folder to the new location.
When the File Explorer has copied the folder, delete the folder from the old location.

Moving folders across different projects is working as expected.

What firewall or network configurations are required for the Desktop Application?

Introduction

For the GeoCloud desktop app to function correctly and synchronise data, your network environment must allow specific traffic. If you are behind a corporate firewall or proxy, please ensure the following rules are configured to allow communication with our services.

Network allowlist rules

Domain / Endpoint	Port	Protocol	Direction	Purpose
`hxauth.com`	443	TCP	Outgoing	User authentication (OpenID)
`hxdr.app`	443	TCP	Outgoing	API communication (GraphQL)
`drive-desktop.geocloud.hexagon.com`	443	TCP	Outgoing	Software auto-updates
`telemetry.geocloud.hexagon.com`	443	TCP	Outgoing	Application logs and metrics
`*.launchdarkly.com`	443	TCP	Outgoing	Feature flags and real-time updates
`localhost`	4200	TCP	Incoming	Local Desktop App communication

Detailed path information

If your firewall requires specific paths rather than wildcards, please ensure these specific URLs are whitelisted:

Authentication: hxauth.com/auth/realms/geo-hxdr-prod/.well-known/openid-configuration
API endpoint: hxdr.app/graphql
Auto-update: drive-desktop.geocloud.hexagon.com
Monitoring: telemetry.geocloud.hexagon.com
Feature flags (LaunchDarkly): clientstream.launchdarkly.com, mobile.launchdarkly.com, app.launchdarkly.com

Note: The application uses localhost:4200 for internal communication between app components. Blocking this port on the local machine may prevent the application from launching or logging in.

Which characters are allowed in file and folder names?

Situation

The cloud storage has a set of characters which are not supported. The character set is limited to support various operating systems such as Windows, Linux, Android, and iOS. These characters have special meanings in the operating systems and are therefore forbidden. Language-specific marks and symbols for letters are not affected by the restriction.

Solution

Avoid the following characters in file and folder names:

@ # % & { } \ / < > * $ ! ' " : + | =

Do not use a blank space at the beginning of a file or folder name.

The GeoCloud desktop app validates file and folder names before synchronisation takes place and will inform you in case the name contains forbidden characters.