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

# Installation Guide: Visible Workstatus Linux App.


# Installation Guide: Visible Workstatus Linux App

Please follow below step
###### Prerequisite:
* Please ensure that Wayland is set to false before starting the installation process.
* Refer to the following document for detailed steps: [How to disbled wayland](https://support.workstatus.io/en/article/how-to-disable-wayland-in-linux-1n15x7m/)
* if previous app is installed then uninstall app : **sudo dpkg -r workstatus**

### Step 1: Download Files
* Download the Workstatus Linux App : 
* For Ubuntu 22 : [Download Ubuntu 22 App](https://app.workstatus.io/downloads/linux/visible/22/7.0/Workstatus-Desktop.deb?1234567)
* For Ubuntu 24 : [Download Ubuntu 24 App](https://app.workstatus.io/downloads/linux/visible/24/7.0/Workstatus-Desktop.deb?12345)

### Step 2: Open Terminal
* Open Terminal from the same directory where the workstatus app file is stored.

### Step 3: Run Installation Commands
* sudo dpkg -r workstatus
* rm -rf  \~/Workstatus
* sudo apt install ./Workstatus-Desktop.deb

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_9ifp3l.png)


![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_d7wfpg.png)


![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_1k6i9di.png)


### Step 4: Open Workstatus App
Open the Applications menu on the Ubuntu system and launch the Workstatus application.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_151pjgm.png)

### Step 5: Enter System Password

* After opening the Workstatus application, an Authentication pop-up will appear.
* Enter the system password and click Authenticate to continue.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_qna34r.png)


### Step 6: Backend App Setup
* After authentication open workstatus app
* For a few seconds, a pop-up will appear indicating that the backend application is being downloaded.
* The downloaded backend application and source setup file will be executed automatically.
* Wait for the setup process to complete.
* Once the setup is completed, the Workstatus Login screen will be displayed.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/image_detpjk.png)

**Note**: Do not close the Workstatus application while the backend application is downloading or being configured.

### Step 7: Login to Workstatus
On the Workstatus Login screen:
* Enter the registered Username.
* Enter the Password.
* Click Login.
Verify that the application starts successfully and the user is logged in.

###### ![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot1_jz4unl.png)

### Step 8: Select Project and Task
* Click on Select Project.
* The assigned project list will open.
* Click on the project on which you want to run the tracker.
* Once you select a project, the assigned task list will open.
* If you want to run the tracker on a specific task, select the task.
* If not, directly click on the Start Timer button.
* If you want to create a task in a project from the desktop app, click on “Create Task”, enter the task name, and the task will be created.
* If you want to complete a task, click on the “Complete Task” checkbox. The task will be marked as completed and hidden from the task list.


###### ![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot12_mv4xq1.png)

###### ![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot13_192mum9.png)

###### ![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot4_nva5cc.png)

###### ![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot5_olauaj.png)

###### ![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot6_5yo2k2.png)

### Step 9 : Troubleshooting
If the Workstatus Desktop App installation fails or required Python dependencies are missing, run the following commands on the Ubuntu system:
* sudo apt update
* sudo apt install python3-pip -y
* sudo apt install software-properties-common -y
* sudo add-apt-repository ppa:deadsnakes/ppa
* sudo apt update
* sudo apt install python3.10 python3.10-venv -y
* sudo apt install ./Workstatus-Desktop.deb
**Note:** Run the commands in the same order. If `add-apt-repository` prompts for confirmation, press **Enter** to continue.