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
• 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
• For Ubuntu 24 : Download Ubuntu 24 App

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

Step 4: Open Workstatus App

Open the Applications menu on the Ubuntu system and launch the Workstatus application.

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.

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.

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.

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.

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.

Updated on: 21/08/2026