> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.workstatus.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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
* Ubuntu 22.04 LTS : [Download Ubuntu 22 App](https://app.workstatus.io/downloads/linux/py/7.0/2204/Workstatus)
* Ubuntu 24.04 LTS : [Download Ubuntu 24 App](https://app.workstatus.io/downloads/linux/py/7.0/2404/Workstatus)

###### 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](https://support.workstatus.io/en/article/how-to-disable-wayland-in-linux-1n15x7m/)    

# 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.
* **Ubuntu 22.04:** [Download Ubuntu 22 App](https://app.workstatus.io/downloads/linux/py/7.0/2204/Workstatus)
* **Ubuntu 24.04:** [Download Ubuntu 24 App](https://app.workstatus.io/downloads/linux/py/7.0/2404/Workstatus)
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.
* **Ubuntu 22.04:** [Download Ubuntu 22 App](https://app.workstatus.io/downloads/linux/py/4.46/2204/Workstatus)
* **Ubuntu 24.04:** [Download Ubuntu 24 App](https://app.workstatus.io/downloads/linux/py/4.46/2404/Workstatus)
###### 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
* [ ] `python3-pip` is installed.
* [ ] setup.sh is executed successfully.
* [ ] Workstatus starts successfully.

###### 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.