15 minutes

Hubstaff Silent App Setup Linux

The Hubstaff Silent app enables organizations to monitor team productivity on company-owned or managed devices, operating in the background.

This feature is only available on Enterprise plans and Team plans with the Silent add-on enabled.
The Hubstaff silent app is a completely different application from the standard application. To download the standard Hubstaff apps, click here.
Silent apps are apps that are deployed on corporate machines and can be managed via a different UI by an administrator.

Creating a silent automatic tracking policy

Before installing the silent application, you’ll need to create an automatic tracking policy so new members can track time. All new corporate users will automatically be added to this policy.

To add a new policy:

Step 1

First, visit your policies page, or select Settings > Activity & tracking in the left Hubstaff side-bar. Next, navigate to the Timer & Tracking tab, then under Automatic tracking policy, click on the Add policy button and choose For company-owned computers.

silent app automatic tracking policy page

Step 2

Fill in the following:

  1. Policy name
  2. Teams/members (this can be blank if you do not yet have members)
  3. Automatically add new members to this policy (required ON for silent app)
  4. Timer start/stop rules
    1. All time – records activities as long as there is computer activity.
    2. Fixed schedule – record activity based on a custom fixed schedule.
    3. Shifts – record activity during scheduled shifts.
  5. Don’t start timer until the first activity – this means the recording won’t start until there is any detected keyboard/mouse activity.
  6. Days of the week and start/stop times – set the days and times the timer will start tracking time.
  7. Starting project – (optional) This is the project where activity will be logged into when the timer starts. A default project will be used automatically if you do not select one.

automatic tracking policy creation

Be sure “Set as the default auto-add policy for your organization” is ON.

Hit Save to commit your changes.

The “Set as the default auto-add policy for your organization” option will simplify the configuration when you have to add a large number of members.

Choose your operating system

Step 1

Click on the Silent app > Setup guide page.
silent app computers page

Step 2

Select your operating system where you will install the Silent app. Then, click on Next: Installation method.

The Silent app download page will only be visible if you are a Silent app customer.

Select Linux and Download

Step 3

Select how you want to install the Silent app: Individual install or Group/batch install (MDM). Then, click on Next: Download & install.

Individual install: Perfect for individual users or small teams. Quick and easy installation process.
Group/batch install (MDM): Deploy across multiple computers with centralized management and configuration.

installation-method-linux


Installation Methods

Important Notes:

  • For Linux and macOS, there is also a terminal command(standard curl command) that, when run on the machine, will download the installer and install the app. (Useful for mass distribution or one-time installation) The macOS and Linux have different commands.
  • Once downloaded, the file can be moved and installed on any machine, and it will create members for your specific organization.
  • We recommend you install the silent application on 1-2 computers to start, then a larger group of 3-4 before rolling it out to the entire organization.
  • If the destination machine had a previous version of the silent app (previously corporate app), installing the new installer file will update it to the latest version.

Individual install

Step 1

Download the Silent app for Linux and follow the instructions. Then, click on Next: Complete Setup.

download-individual-Linux

Step 2

After downloading the installer file, go to the download history on your web browser and open file location:

downloadSilentAppLinux

Step 3

1. Open a new terminal on the Linux machine, drag the .sh file to the terminal window and add chmod +x before the file path, this will grant executable permissions to the file (if not granted already).
2. Copy the previous command but this time remove chmod +x and  instead add sudo before the path location (remove any quotation marks).

linux-commands

Step 5

Complete setup: If the app installed succesfully, the silent app is now running and will automatically track time.

After installation, data upload depends on the device’s internet connection, it may take a few minutes for the first activity to appear in the Hubstaff dashboard.

success-individual-Linux


Group/batch install (MDM)

Step 1 (Optional)
Download the installer for MDM deployment, or copy the code to install via terminal.

group-installation-linux

Step 2

Distribute the Silent app .sh: Download and upload the .sh file to distribute via your preferred MDM tool.

Step 3 (Optional)

Distribute the Silent app via script: Copy the code and distribute via your preferred MDM tool to your devices.

Step 4

Complete setup: If the app installed succesfully, the silent app is now running and will automatically track time.

After installation, data upload depends on the device’s internet connection, it may take a few minutes for the first activity to appear in the Hubstaff dashboard.

success-silentapp-linux


Account Provisioning

If an earlier version of the silent app is already installed and running on the computer when a newer version is installed, a new user account will not be created if a silent app user already exists for that computer or user.

When installing the silent app on a machine for the first time, after install/restart, a new Hubstaff member will be automatically created using the following information collected from the machine:

  • os_username
  • If available: Firstname / Lastname
  • OS and version
  • Machine name

Following installation

  • Time tracking should begin immediately / data visible within Hubstaff web-app within 10-15 minutes of install completion.
  • If not reflected, you can force a process restart by doing one of these options:
    • Sign out / Sign in from the operating system session.
    • Restart the device.

Computers page

computers tab on silent app page

All new computers added via silent app will appear within the Computers page, found in the left side-bar under the Silent app. Filtering by the “Date added” column will show the most recently added computers at the top.

computers page on silent app page


Merging silent app members

The silent app will auto-provision Hubstaff members after installation on a new computer. If the member of the new computer already has a Hubstaff member, you may use the Merge Members page to select both and merge devices from both into a single member, you will find detailed steps for this process in the: How to Merge Silent App Members article

Back to top