Documentation

Support

Unity Hub

Install the Unity Hub on Linux

Install Unity Hub on Ubuntu, RHEL, or CentOS, and manage updates via package repositories.
Read time 3 minutesLast updated 7 hours ago

To install the Unity Hub on an Ubuntu Linux distribution, add the Unity Hub repository and the public signing key to verify the integrity of the packages.
Note
You need curl on your device to run the following scripts. To install it, run the command
sudo apt-get install curl
.
  1. To add the public signing key, run the following command:
    sudo install -d /etc/apt/keyringscurl -fsSL https://hub.unity3d.com/linux/keys/public | sudo gpg --dearmor -o /etc/apt/keyrings/unityhub.gpg
  2. To add the Unity Hub repository (x86_64/amd64 only) you need an entry in
    /etc/apt/sources.list.d
    . Run the following command to add the Unity Hub repository:
    echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/unityhub.gpg] https://hub.unity3d.com/linux/repos/deb stable main" | sudo tee /etc/apt/sources.list.d/unityhub.list
  3. Update the package cache and install the package:
    sudo apt updatesudo apt install unityhub
For some systems, you might need to check the following:
  • The directory
    /etc/apt/keyrings
    exists.
  • The user or group installing the Hub has write permissions to the
    /etc/apt/keyrings
    directory.
  • The user or group installing Hub has at least read permissions to the resulting file
    /etc/apt/keyrings/unityhub.gpg
    .
To remove the Unity Hub from the system, run the following command:
sudo apt remove unityhub

Install a beta version of the Unity Hub on Linux

Unity distributes the Unity Hub beta versions 3.0 and higher for Linux through the same repository but under a different distribution.
  1. Add the public signing key:
    sudo install -d /etc/apt/keyringscurl -fsSL https://hub.unity3d.com/linux/keys/public | sudo gpg --dearmor -o /etc/apt/keyrings/unityhub.gpg
  2. Add a beta repository entry to your
    /etc/apt/sources.list.d/:
    folder:
    echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/unityhub.gpg] https://hub.unity3d.com/linux/repos/deb unstable main" | sudo tee /etc/apt/sources.list.d/unityhub-beta.list
  3. Update the package cache and install the package:
    sudo apt updatesudo apt install unityhub=<version>
Where
<version>
follows the format of
3.4.1-beta.1
.

Install the Hub on Red Hat Enterprise Linux (RHEL) or CentOS

Note
The Unity Hub doesn't support Red Hat Enterprise Linux (RHEL) or CentOS distributions.
To install the Unity Hub on Red Hat Enterprise Linux (RHEL) or CentOS, use the following commands. To install the latest version of the Unity Hub:
sudo sh -c 'echo -e "[unityhub]\nname=Unity Hub\nbaseurl=https://hub.unity3d.com/linux/repos/rpm/stable\nenabled=1\ngpgcheck=1\ngpgkey=https://hub.unity3d.com/linux/repos/rpm/stable/repodata/repomd.xml.key\nrepo_gpgcheck=1" > /etc/yum.repos.d/unityhub.repo'
To install beta versions of the unity Hub:
sudo sh -c 'echo -e "[unityhub-beta]\nname=Unity Hub Beta\nbaseurl=https://hub.unity3d.com/linux/repos/rpm/unstable\nenabled=1\ngpgcheck=1\ngpgkey=https://hub.unity3d.com/linux/repos/rpm/unstable/repodata/repomd.xml.key\nrepo_gpgcheck=1" > /etc/yum.repos.d/unityhub_beta.repo'
Then update the package cache and install the package:
sudo apt updatesudo apt install unityhub

Auto Update of Unity Hub on Linux

Once you've configured the Unity Hub repositories in your package managers, the Hub automatically checks for a new version periodically based on the configurations defined in the operating system settings. You might receive the following popups from your Software Manager when a new version is available.

Debian / Ubuntu

Update Notification on Ubuntu

Update Notification on Ubuntu

You can also check for new versions by running the following command in your terminal:
sudo apt update

RHEL / CentOS

Update Notification on Centos

Update Notification on Centos

To check for new versions, run the following command in your terminal:
sudo yum check-updatesudo yum update unityhub

Linux installation troubleshooting

Only the beta version displays if you have both
STABLE
and
UNSTABLE
repositories configured. By default, the
apt
command lists the latest version of the package. To install the stable version of the Unity Hub, you can do the following:
Install the stable version of the Unity Hub in Debian:
  1. Disable the beta repository.
    sudo mv /etc/apt/sources.list.d/unityhub-beta.list /etc/apt/sources.list.d/unityhub-beta.list.baksudo apt updatesudo apt-get install unityhub
  2. Query the specific version of the Hub.
    sudo apt-get install unityhub=3.x.x
Install the stable version of the Unity Hub in Rel/CentOS:
  1. Disable the beta repository.
    sudo mv /etc/yum.repos.d/unityhub_beta.repo /etc/yum.repos.d/unityhub_beta.repo.baksudo yum check-updatessudo yum install unityhub
  2. Query the specific version of the Hub.
    sudo yum list unityhubsudo yum install unityhub-<version info>

This can happen when
sources.list.d
doesn't exist or you don't have access to create the file. To fix this error, manually create the folder and an empty
unityhub.list
file with the following commands:
sudo mkdir /etc/apt/sources.list.dsudo touch /etc/apt/sources.list.d/unityhub.list

If you receive a lock file error, an associated process number should also display. In this example, the process number is
4076
.
E: Could not get lock /var/lib/dpkg/lock-frontend. It is held by process 4076
If this error displays, use the following command to stop the process. In the command, replace
4076
with the process number that your device displays.
sudo kill -9 4076
If you remove the Unity Hub after you perform this command and this error shows up, follow the instructions in the command line to fix it.
sudo apt-get remove unityhubE: dpkg was interrupted, you must manually run 'sudo dpkg --configure -a' to correct the problem. ubuntity@ubuntu:~$ sudo dpkg --configure -a