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

# Workstatus Linux Silent App Installation via MDM Using Ansible

# Ubuntu 22.04  and 24.04 Silent App Installation via Ansible

### Overview
This document explains how to install the **Workstatus Silent App** remotely on a Linux user system using **Ansible** from a Linux server system.
### Installation Flow
**Linux Server → Ansible → Linux User System → Workstatus Silent App**

### 1. Server System Requirements
The server system is the Linux machine from which the Workstatus Silent App installation will be triggered.
The following packages are required on the server:
* The server system must be a **Linux-based** system.
* Ansible
* SSH
* Software Properties Common

###### 1.1 Install Ansible
Open the terminal on the server system and run the following commands:
* **sudo apt update**
* **sudo apt install ssh -y**
* **sudo apt install software-properties-common -y**
* **sudo add-apt-repository --yes --update ppa:ansible/ansible**
* **sudo apt install ansible -y**
Verify Ansible Installation
* **ansible --version**
If Ansible is installed successfully, the installed Ansible version will be displayed.

###### 1.2 Enable SSH on the Server
SSH is required for communication between the Ansible server and the target Linux system.
**Note**: This step is optional if SSH is already enabled.
**Start the SSH service:**
* sudo systemctl start ssh
**Enable SSH to start automatically after reboot:**
* sudo systemctl enable ssh
**Check the SSH service status:**
* sudo systemctl status ssh
**The status should show:**
Active: active (running)

### 2.User System Requirements
The user/target Linux system is the machine where the Workstatus Silent App will be installed.
###### 2.1 System Wayland should be disbled
[__How to disable Wayland in Linux__](https://support.workstatus.io/en/article/how-to-disable-wayland-in-linux-1n15x7m/)

###### 2.2Install Ansible
Install Ansible on the user system if required.
Run following command:
* **sudo apt update**
* **sudo apt install ssh -y**
* **sudo apt install software-properties-common -y**
* **sudo add-apt-repository --yes --update ppa:ansible/ansible**
* **sudo apt install ansible -y**
Verify the installation:
* **ansible --version**

### 3. Server System Actions
###### 3.1 Configure Inventory File
Download the [Linux Silent App Zip file](https://app.workstatus.io/downloads/documents/linux/Linux_Silent_Ansible.zip) provided for the Workstatus Silent App installation.
Extract zip file and open inventory file. The inventory file contains the details required to connect to the user's Linux system.
**Open inventory.ini and enter:**
* **User system IP address**
* **System username**
* **System password**
* **Workstatus user email address**
For multiple Windows systems, copy the entry to a new line and update the IP address, username, password, and email for each user.
Example
1XX.1XX.3.X user=admin pass=admin email=__useremail@example .com__
1XX.1XX.3.X user=admin pass=admin email=__useremail@example .com__

**Note** : Replace the values with the actual user's details.

###### 3.2. Run the Installation
Open the terminal in the directory where inventory.ini and setup file are stored and Run following command.
* **source** setup.ssh.sh
The script will use the information from inventory.ini to connect to the target Linux system and install the **Workstatus Silent App**.

### 4.User Action After Installation
* After the Workstatus Silent App is successfully installed via Ansible, the user must **restart the system** to complete the installation.
* After the system restart, the **Workstatus Silent App will start automatically and work on the user's system**.


### 5. Verify Installation
Log in to the **Workstatus Admin Account** and navigate to:
**People → Employees → Select the Employee**
Under the employee's name, verify that the **Working** status is displayed. This confirms that the Workstatus Silent App is working correctly on the user's system.

### 5. Troubleshooting
###### 5.1 SSH Connection Failed
Check whether SSH is running on the target system:
* sudo systemctl status ssh
If SSH is not running:
* sudo systemctl start ssh
Enable SSH:
* sudo systemctl enable ssh
Test the connection manually from the Ansible server:
* ssh username@IP\_ADDRESS
Example:
ssh username@1XX.1XX.X.X

###### 5.2 Check Network Connectivity
From the server, check whether the target system is reachable:
* ping 1XX.1XX.X.X
Replace 1XX.1XX.X.X with the target system's IP address.

###### 5.3 Verify Ansible Connection
Run:
* ansible all -i inventory.ini -m ping
If the connection is successful, Ansible should return:
* SUCCESS

### 6. Important Notes
* The **server system** must be able to communicate with the target Linux system over SSH.
* The target Linux system must have a valid Linux username and password.
* Ensure the IP address entered in `inventory.ini` is correct.
* `inventory.ini` and [__setup.ssh.sh__](https://setup.ssh.sh/) must be in the same directory.
* Make sure the required firewall/SSH port is accessible.
* Do not share `inventory.ini` publicly because it may contain user credentials.
* Use Ansible Vault or SSH keys when handling production credentials.