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

# Linux Ubuntu 24.04 Visible App Installation via Ansible

# Linux Ubuntu 24.04 Visible App Installation via Ansible

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

### 1. Server System Requirements
The server system is the Linux machine from which the Workstatus Visible 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 Visible 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.Configure Inventory File

Download the [inventory.ini](https://app.workstatus.io/downloads/documents/linux/2404/inventory.ini) file provided for the Workstatus Visible App installation.
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 Ubuntu 24.04 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=user@example.com
1XX.1XX.3.X user=admin pass=admin email=user@example.com

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

### 4. Download Setup Script
Download the [**`setup.ssh.sh`**](https://app.workstatus.io/downloads/documents/linux/2404/setup-shh.sh) file.
The following two files must be present in the **same directory**:
* inventory.ini
* setup.ssh.sh
Example directory structure:
Workstatus\_Ansible/
├── inventory.ini
└── setup.ssh.sh

### 5. Run the Installation
Open the terminal in the directory where inventory.ini and  setup-ssh.sh 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 Visible App**.

### 6. Verify Installation
* After the installation is completed, log in to the target Linux system and verify that the Workstatus Visible App has been installed successfully.
* Check whether the application is running.
* You can also verify the installed Workstatus files/processes according to the Workstatus Linux installation structure.

### 7.Troubleshooting

###### 7.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 pradeep@192.168.3.7

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

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

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