Overview

The HR360 Hub desktop application runs on the employee’s computer and works together with the HR360 Hub Portal to record activity, such as keyboard and mouse activity counts, idle time, and screenshots, for the Productivity Insights features. On Linux, the application is installed using a ready-made installer script, install.sh, which is supplied inside a zip file named HR360Hub-linux-x64 followed by the build date and time.

The installer does most of the work automatically. It installs the application for the current user, sets up screen capture, checks the screenshot tools, and offers to add two small GNOME Shell extensions. The user only needs to run the script and answer a few prompts.

This guide explains how to:

• Download and extract the installer, and open it in a terminal.
• Prepare and run the installer.
• Answer the installer’s prompts, and understand what each answer means.
• Enter the sudo password when requested.
• Confirm the installation and open the app.
• Resolve the most common installation messages.

📜 Note:  The steps in this guide were captured on a Fedora system running a GNOME Wayland session. Package names and prompts may differ slightly on other Linux distributions or desktop sessions.

Prerequisites

Before starting the installation, ensure the following are in place:

• The computer is running Linux with the GNOME desktop (for example, Fedora with GNOME).
• The HR360Hub-linux zip file, as provided by your organization, has been downloaded to the computer, for example into the Downloads folder.
• The user has sudo (administrator) rights and knows their account password.
• The computer is connected to the internet, as system packages and GNOME Shell extensions are installed from online sources.
• The user is logged in to the computer with the account that will use the app, since the app is installed for the current user only.

Section 1: Installation Workflow

The diagram below shows the whole installation from start to finish in nine steps. Orange steps are actions you take; the grey step is carried out by the installer on its own. Follow the steps from top to bottom, and refer to Section 2 for the detailed instructions and screenshots for each one.

💡 Tip:  Keep the terminal window open until the installer finishes. It may stop and wait for you at the prompts in Steps 5, 6 and 8.

Section 2: Installing the Desktop App

2.1. Step 1: Download and Extract the Installer

1. Download the HR360Hub-linux zip file to the computer. The file is named like HR360Hub-linux.
2. Open the Files app and go to the Downloads folder (or the folder where the zip file was saved).
3. Extract the zip file, for example by right-clicking it and choosing the extract option. A folder named HR360Hub-linux is created.

📜 Note:  If more than one HR360Hub-linux zip file is present, as in Figure 2, use the one with the most recent date and time, as this is the latest build.

2.2. Step 2: Open the Folder in a Terminal

1. In the Files app, open the extracted HR360Hub-linux folder.
2. Right-click on an empty area inside the folder.
3. Choose Openin Console from the menu (shortcut: Ctrl + .).

A terminal window opens, already pointing at the folder.The prompt in the terminal ends with the folder name, for example ~/Downloads/HR360Hub-linux, which confirms that you are in the right place.

2.3. Step 3: Make the Installer Ready to Run

In the terminal, type the following command exactly as shown, including the spaces, and press Enter. This allows the install.sh script to run. No message is shown when it succeeds.

📜 Note:  Type the command exactly as shown in the table above: chmod +x install.sh, with a plus sign before the x and a space before install.sh.

2.4. Step 4: Start the Installer

Type ./install.sh and press Enter. The installer starts and, on a Wayland session, immediately asks the question described in Step 5.

📜 Note:  The app is installed in the current user’s home directory, so a separate installation is required for each user account that needs the app.

2.5. Step 5: Choose Whether to Allow Keyboard and Mouse Activity Counts

On a Wayland session, the installer explains that keyboard and mouse activity counts need read access to /dev/input, which is granted by adding your user account to the input group. It then asks:

The installer states that it only reads raw keyboard and mouse events (key presses and releases, and mouse movement and clicks). It does not read the actual text typed or which application is in focus.

The installer allows you to continue in one of two ways. Choose the option that suits your organization, or check with your administrator if you are unsure.

Option A: Allow activity counts

1. Type y at the [y/N] prompt.
2. Press Enter, and continue with Step 6.

Option B: Install without activity counts

1. If the installer is already running, stop it by pressing Ctrl + C.
2. Enter HR360_INPUT_GROUP=no ./install.sh and press Enter.
3. Continue with the remaining steps. The installer may still ask for your password in Step 6 to install system packages.

⚠️ Important:  The capital N in [y/N] means the default answer is No. Pressing Enter without typing y declines the request, and the installer states that this step is required to continue. To install without activity counts, use Option B instead of answering n.

2.6. Step 6: Enter the sudo Password

The installer then asks for your account password so that it can make system changes and install packages. A short message beginning We trust you have received the usual lecture... may appear first. This is a standard Linux reminder and needs no action.

1. At the [sudo] password prompt, type the password for your account.
2. Press Enter. For security, nothing appears on screen while you type, which is normal.

2.7. Step 7: Wait for the Screen Capture Setup and Checks

The installer now installs and checks each screen capture component one by one. Wait for it to finish; no action is needed.

⚠️ Important:  If the last line shows screen capture: NOT WORKING — xdg-desktop-portal is not running, the app is installed but screen capture will not work yet. Continue with the installation, then follow Section 4 to resolve this.

The installer then tests the screenshot tools on the computer. Each tool is given up to 10 seconds, so the installer may pause briefly.

A result such as gnome-screenshot... installed but not capturing means the tool is present but did not take a test screenshot. The installation continues regardless.

2.8. Step 8: Install the GNOME Shell Extensions

The installer then asks whether to install two GNOME Shell extensions from extensions.gnome.org. Type y and press Enter at each prompt.

The first prompt, shown on a Wayland session, is for the [email protected] extension. It allows the app to report window titles and detect applications reliably.

The second prompt is for the [email protected] extension. It adds the system tray icon used to reopen the app after its window is closed.

💡 Tip:  Answer y to both prompts so that applications are identified reliably and the app can be reopened from the system tray.

2.9. Step 9: Open the HR360 Hub App

When the installer has finished and the terminal prompt returns, HR360 Hub is ready to use.

1. Open the Activities overview (press the Super key, or click Activities at the top left of the screen) and show all applications.
2. Find the HR360Hub icon. The name may be shortened, for example HR36…, in the application grid.
3. Click the icon to open the app.

Section 3: After Installation

Once the app is installed, complete the following checks.

1. Review the installer output and note any line that shows NOT WORKING or not capturing. These are explained in Section 4.
2. If the extensions were installed and do not seem to be active, log out of the computer and log back in. GNOME on Wayland normally needs a new login before newly installed extensions become active.
3. Open HR360 Hub from the Activities overview, as shown in Step 9.
4. Sign in with your HR360 Hub account details when prompted.

📜 Note:  Employee activity data appears in the HRMS Portal only after the employee has checked in through the desktop app.

Section 4: Troubleshooting

The following table lists the messages most likely to appear during installation and what to do about each.

📜 Note:  Running ./install.sh again is safe if a step needs to be repeated. Run it from the same HR360Hub-linux folder.

Summary

The following table provides a complete step-by-step summary of the Linux desktop app installation workflow: