> ## 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 Desktop App Installation Guide – Ubuntu 26 Beta Version

# Workstatus Desktop App Installation Guide – Ubuntu 26 Beta Version

   Note: This installation guide is specifically for the Ubuntu 26 Beta version of the Workstatus Desktop App.
### Step 1: Download the Workstatus App
* Download the [Workstatus Desktop.deb](https://app.workstatus.io/downloads/linux/visible/26/Workstatus-Desktop.deb) **package** for Ubuntu 26 Beta.
* Save the downloaded `Workstatus-Desktop.deb` file in an easily accessible location, such as the **Downloads** folder.
### Step 2: Install the Workstatus App
###### 2.1 Open Terminal
Open the Terminal application on your Ubuntu 26 system.
###### 2.2 Remove the Existing Workstatus Installation
If an older version of Workstatus is already installed, run:
* sudo dpkg -r workstatus-desktop
![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot-from-2026-09-07-12-_6fhizb.png)

Enter your system password when prompted.

###### 2.3 Remove the Existing Workstatus Folder
Run the following command:
* rm -rf \~/Workstatus
![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot-from-2026-09-07-12-_13en58x.png)


###### 2.4 Install the Ubuntu 26 Beta Package
Navigate to the directory where the `Workstatus-Desktop.deb` file was downloaded.
For example:
* cd \~/Downloads
Then install the application:
* sudo apt install ./Workstatus-Desktop.deb
![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot-from-2026-09-07-12-_1gti7ld.png)

Follow the instructions displayed in the Terminal.

###### 2.5 Add the Current User to the Input Group
Run:
* sudo usermod -aG input $USER

This permission is required for the Workstatus application to access the necessary system input information.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot-from-2026-09-07-12-_1w4mzub.png)



###### 2.6 Restart the System
Restart the Ubuntu system to apply the newly added group permissions.
* sudo reboot

###### 2.7 Verify the Input Group
After the system restarts, open Terminal and run:
* newgrp input
Verify that the **current system username** is displayed correctly.

### Step 3: Open the Workstatus App
After restarting the system:
* Open the **Workstatus** application.
* Wait for the application to initialize.
* An authentication pop-up will appear.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot-from-2026-09-07-12-_ynwljz.png)


### Step 4: Authenticate Using the System Password
After opening Workstatus, an **Authentication** pop-up will appear.
* Enter your **Ubuntu system password**.
* Click **Authenticate**.
* Wait for the authentication process to complete.

**Important:** Enter the password of the currently logged-in Ubuntu system user.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot-from-2026-09-07-12-_13sh3tx.png)

### Step 5: Backend App Setup
After successful authentication:
* The Workstatus application will start the backend setup process.
* For a few seconds, a pop-up will appear indicating that the **backend application is being downloaded**.
* The backend application and the required source/setup files will be downloaded automatically.
* The downloaded setup files will be executed automatically.
* Wait until the backend setup process is completed.
Once the setup is complete, the **Workstatus Login** screen will be displayed.

**Important:** Do not close the Workstatus application while the backend setup is in progress.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot-from-2026-09-07-12-_1vjo7pe.png)

### Step 6: Log in to Workstatus
Once the **Workstatus Login** screen appears:
* Enter your Workstatus account credentials.
* Click **Login**.
* Wait for the application to connect and initialize.
* After successful login, Workstatus will be ready to use.


![](https://storage.crisp.chat/users/helpdesk/website/-/f/3/e/4/f3e4eb6758a66800/screenshot-from-2026-09-07-12-_1l3d8qo.png)

### Installation Flow
**Download App → Install `.deb` Package → Add Input Permission → Restart System → Open Workstatus → Authenticate → Backend Setup → Login**
### Important Notes
* This guide is applicable to the **Ubuntu 26 Beta version**.
* Make sure you have **sudo/root privileges** before starting the installation.
* Restart the system after adding the user to the `input` group.
* Do not close the application while the backend application is being downloaded or configured.
* Use the correct Ubuntu system password during authentication.
* Ensure the Workstatus `.deb` package is downloaded completely before starting the installation.