Articles on: Apps

How to Install Workstatus Linux App in Silent mode

Workstatus Linux Silent App Installation Guide

This guide explains how to install and configure the Workstatus Linux Silent App on Ubuntu systems.


There are two supported installation scenarios:

  1. Admin Profile Installation – User has sudo access.
  2. User Profile Installation – User does not have sudo access and an Admin Profile is required for the profile-runner configuration.


Supported Operating Systems


Prerequisite:
  • Ubuntu systems using Wayland are not supported. Wayland must be disabled before installing the Workstatus Linux Silent App.

For instructions, refer to: How to Disable Wayland in Linux


Method 1: Installation with Admin/Sudo Access

Use this method when the user has an account with sudo privileges.

Step 1 : Download the Workstatus Linux App

Download the appropriate Workstatus Linux application and save it in a directory of your choice.

After downloading, open Terminal and navigate to the directory containing the Workstatus file.
Example: cd /path/to/downloaded/file


Step 2 : Create the User Token File

In the same directory where the Workstatus application is located, create a file named user_token_file.txt.
Run following command : touch user_token_file.txt

Step 3 : Owner Action for copy Silent Token
  • Log in to the Workstatus Web App.
  • Navigate to People → Employees.
  • Select the required Member.
  • Click the three-dot menu.
  • Select Copy Silent Token.
  • Send to user
Step 4 : User Action
  • Create the token file bu using following command: touch user_token_file.txt
  • Paste the token into user_token_file.txt.
  • Save the file.

Important: Make sure the token is pasted correctly into user_token_file.txt without unnecessary spaces or additional text.


Step 5 : Install the Required Dependencies

Open Terminal in the same directory where the Workstatus file is located.
Run the following commands in sequence:

  • Install pip : sudo apt install python3-pip
  • Make the Workstatus application executable: chmod +x Workstatus
  • Launch Workstatus : nohup ./Workstatus >/dev/null 2>&1 &
  • Navigate to the Workstatus directory : cd && cd Workstatus
  • Install required system dependencies: sudo apt install -y tesseract-ocr scrot xdotool x11-utils || echo "[WARN] Failed to install some system dependencies."
  • Run the setup script : source setup.sh


Step 6 : Restart the System
  • Restart the system to ensure the configuration is applied and Workstatus starts automatically.


Step 7 : Verify the Installation

After completing the installation:

  1. Open System Monitor.
  2. Search for Workstatus in the running processes.
  3. Multiple Workstatus processes/instances may be visible.
  4. If Workstatus processes are running, the Silent App has started successfully.



Troubleshooting – Workstatus Is Not Running

If Workstatus does not appear in System Monitor, perform the following checks.

1: Verify the Token File

Confirm that:

  • user_token_file.txt exists in the correct directory.
  • The file contains the employee's Stealth Token.


Important Notes
  • Use the correct Workstatus build according to the Ubuntu version.
  • The user_token_file.txt must contain the correct employee Stealth Token.
  • Do not share an employee's Stealth Token with unauthorized users.
  • The installation commands should be executed from the appropriate Workstatus installation directory.
  • If the application does not appear in System Monitor after installation, follow the troubleshooting steps above.



Method 2: Installation Without Sudo Access

Use this method when the end user does not have sudo access.
In this scenario, the initial application setup is performed by the user, while the Admin Profile is used to configure the profile runner. The end user can then run Workstatus under their own user profile.

Step 1: Download the Workstatus Linux App

Download the appropriate Workstatus application and save it in the user's preferred directory.

Step 2: Create the User Token File
  • Open Terminal in the directory where the Workstatus application was downloaded.
  • Create the token file: touch user_token_file.txt


Step 3: Owner Action for Copy Employee Silent Token
  • Log in to the Workstatus Web App.
  • Navigate to People → Employees.
  • Select the required Member.
  • Click the three-dot menu.
  • Select Copy Silent Token.
  • Send to user
Step 4 : User Action
  • Create the token file bu using following command: touch user_token_file.txt
  • Paste the token into user_token_file.txt.
  • Save the file.
Step 5: Run the Workstatus Setup

Open Terminal in the Workstatus download directory and run the following commands in sequence:

  • su {{Admin Profile}}
  • sudo apt install python3-pip
  • chmod +x Workstatus
  • nohup ./Workstatus >/dev/null 2>&1 &
  • cd && cd Workstatus
  • source setup.sh


Step 6: Restart the System

Restart the system to ensure the configuration is applied and Workstatus starts automatically.


Step 7 : Verify Workstatus Is Running

After restarting the system:

  • Log in to the employee's user account.
  • Open System Monitor.
  • Search for Workstatus.
  • Verify that Workstatus processes are running.

If Workstatus processes are visible, the Silent App is running successfully.


Troubleshooting

If Workstatus is not visible in System Monitor, perform the following checks.

1.Check the User Token

Verify that user_token_file.txt:

  • Exists in the correct location.
  • Contains the correct Stealth Token.
  • Is accessible by the user running Workstatus.
2.Admin/Sudo Installation


Important Notes
  • Use the Ubuntu 22.04 build only on Ubuntu 22.04 and the Ubuntu 24.04 build only on Ubuntu 24.04.
  • Wayland must be disabled.
  • The correct employee Stealth Token must be used.
  • The Admin Profile configuration is required when the end user does not have sudo access.
  • Commands requiring administrator privileges must be executed by an authorized administrator.
  • Do not share Stealth Tokens with unauthorized users.
  • After completing the User Profile Configuration, restart the system.
  • Verify Workstatus from System Monitor after installation.

Updated on: 19/08/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!