Have a problem 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.
Step 1: Remove old versions of the desktop app
- Uninstall the old version of the app
- Remove any old files
- Remove the cache folder
- 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
NOTE:
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.
- Open the file explorer and use search to navigate to Linux: ~/.Upwork
- Delete the folder
Be sure to restart the app after making changes.
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:
- Select the Power Off/Log out button and choose Log Out
- Select your user profile
- Locate the cogwheel icon in the bottom-right corner and select Ubuntu on Xorg
- Enter your password
- Activate the Time Tracker
Be sure to restart the app after making changes.
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 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
- Open the folder containing the package
- 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
Beesu:
$sudo dnf -y install beesu
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
Installation on Centos 7 isn't possible due to lack of certain necessary libraries. Please use a supported Linux distribution.
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.
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.
~/.Upwork/Upwork/Updates//
For example:
~/.Upwork/Upwork/Updates/4.1.297.0/update.deb
Due to the large variations of Linux distributions and versions, we can't provide answers to all problems you may encounter.
