✔️ We are making updates to the Upwork Desktop App and starting on Monday, Oct. 30, 2023, we will gradually send out an automatic pop-up notification to customers to complete the update.

Things to know:

  • We will not send the update while you are actively logging time on a contract (we don’t want to interrupt your work). We’ll wait until you’ve turned the Time Tracker off to send the update.
  • You’ll be required to update to the latest version of the app immediately once you see the pop-up. The update is needed for authentication reasons and cannot be scheduled for later. The update will also streamline the sign-in process going forward.
  • Once you’ve updated to the latest version, you’ll be asked to log into Upwork again and then redirected back to the desktop app. You’ll need to log in there as usual to access features such as Upwork Messages.


If you are using Linux 32-bit, you will need to upgrade to a supported operating system because Linux 32-bit will no longer work with the app. Supported systems are: Ubuntu 22.04 LTS 64-bit, Windows 11 64-bit, Windows 10 64-bit, and macOS 13 Ventura.

Having a problem with the app that is not covered below?

Go here for more troubleshooting tips.

To make sure our desktop app works for as many people as possible, it supports a wide variety of Linux operating systems. Here are tips on installation and the most common troubleshooting steps for a variety of Linux distributions.

Troubleshoot an outdated version of the desktop app (Linux)

Step 1: Remove old versions of the desktop app

  1. Uninstall the old version of the app
  2. Remove any old files
  3. Remove the cache folder
  4. Download the most up-to-date version for your respective operating system

Be sure to restart the app after making changes.

Step 2: Clear all Upwork tasks

Clear and end all processes related to Upwork.

Be sure to restart the app after making changes.

Step 3: Delete the Upwork folder


If you delete the Upwork folder, any time that has not been uploaded to your Work Diary will be lost. This will impact time logged while offline.

  1. Open the file explorer and use search to navigate to Linux: ~/.Upwork
  2. Delete the folder

Be sure to restart the app after making changes.

Upwork screenshots no longer supported on Linux Wayland

Upwork screenshots are no longer supported on Wayland. If you’re unable to use the Time Tracker after the latest Linux update, it may be because the Wayland display server might cause issues with the Time Tracker screenshots. We recommend using the Xorg windowing system. To activate Xorg:

  1. Select the Power Off/Log out button and choose Log Out
  2. Select your user profile
  3. Locate the cogwheel icon in the bottom-right corner and select Ubuntu on Xorg
  4. Enter your password
  5. Activate the Time Tracker

Be sure to restart the app after making changes.

Install on Debian 8, Ubuntu 16.04, Mint

If app installation using graphical install tools fails, please try running the install from the command line.

On 64-bit:

$ sudo dpkg -i upwork_amd64.deb
 $ sudo apt-get -f install
Install on Fedora 24

Install the Upwork package and then install the beesu manually. If app installation using graphical install tools fails, please try running the install from the command line.

GUI installation

  1. Open the folder containing the package
  2. Right-click to show the context menu and select Open With Software Install

Command line installation

On 64-bit:

$sudo dnf -y --nogpgcheck install upwork_x86_64.rpm

On 32-bit:

$sudo dnf -y --nogpgcheck install upwork_i386.rpm


$sudo dnf -y install beesu
Install on OpenSuSE 42.1

App installation using graphical install tools isn't possible. The zypper subsystem caches the packages and without clearing the cache, it will install the previous version. Simply removing the app doesn't help. Please run install from the command line as shown.

On 64-bit:

$ sudo zypper remove - upwork
 $ sudo zypper clear --all
 $ sudo zypper install upwork_amd64.rpm

On 32-bit:

$ sudo zypper remove - upwork
 $ sudo zypper clear --all
 $ sudo zypper install upwork_i386.rpm
Install on Centos 7 — Not possible

Installation on Centos 7 isn't possible due to lack of certain necessary libraries. Please use a supported Linux distribution.

Icon Missing in System Tray

This issue affects Ubuntu pre-17.04, Fedoras, and other Red Hatoids. To resolve the issue, install a Gnome extension: TopIcons Plus.

  • TopIcons Plus requires GNOME Shell 3.16 or newer, which can be found in Software Center or installed via the command line (command varies per OS distro)
  • You may need to restart your session if the plugin is not immediately recognized by the Gnome shell
  • After completing the items above, the Upwork icon should appear in the tray on the next launch of the Upwork app

Alternatively, beginning in Ubuntu 11.04, icons don't appear in the system tray by default. You'll need to add the app to your list of allowed apps for convenient access in the systray. It was fixable for 11.04 by one CLI command, or by Dconf Editor (see previous link). Starting Ubuntu 13.04 this ability was removed, but there is a workaround. Root privileges and restarting the computer will be necessary. Alternatively, if you want to see an icon in the tray you can turn on Notification Area on the Panel, and you'll see the Upwork icon.

Application Stuck in Update Loop

If you upgrade and restart but the app displays the upgrade dialog again, there could be some problems with application dependencies. Try running the update manually from the command line. You can find the downloaded install package in.


For example:

Linux-Specific Issues Not Listed Here

Due to the large variations of Linux distributions and versions, we can't provide answers to all problems you may encounter. Fortunately, we have a large community of users who may already have solved similar problems. Try searching our forums or posting a new question there

Was this article helpful?

0 out of 0 found this helpful