Documentation

Install Unity Version Control on Linux

Install and set up Unity Version Control on Linux using packages for your distribution.

Read time 5 minutes

Last updated 21 days ago

This guide explains how to install Unity Version Control (formerly Plastic SCM) on Linux using packages for your distribution. First, choose the installation type that you want to use. Then refer to the instructions for the following operating systems:

Debian
Ubuntu
Fedora
Red Hat / CentOS
OpenSUSE
Eclipse plug-in

Choose your installation type

Select the Unity Version Control installation that matches your development needs. The following installation types are available:

Cloud Edition
Complete installation (server and client)
DVCS packages
Proxy server
Install a specific version

Cloud Edition

Use Cloud Edition (package:

plasticscm-cloud

) to collaborate with your team using Unity's hosted infrastructure. After you complete your distribution's repository setup, install the Cloud Edition package using your Package Manager. When you first launch

plasticgui

, enter your Unity Version Control Cloud Edition credentials to connect with your organization and start collaborating.

Complete Installation (Server and Client)

Use the complete installation to get both server and client tools with full control over your version control setup. This setup is ideal for teams that use on-premises servers. The following packages provide different components:

```
plasticscm-complete
```
: Complete Unity Version Control experience.
- ```
plasticscm-client-complete
```
  : All client tools for your development workflow.
  - ```
  plasticscm-client-core
```
  : Command line utilities for script automation.
- ```
plasticscm-client-gui
```
    : Visual tools including plasticgui, gluon, and mergetool for visual workflows.
- ```
plasticscm-server-core
```
  : Unity Version Control server built on .NET Core with systemd management.

DVCS packages

Use DVCS packages (

plasticscm-dvcs

) for distributed development workflows when you want to work with local repositories that sync with your team's central server. After installation, launch

plasticgui

to get started. You can connect to your on-premises server or use the default local setting to work with your personal local server.

Proxy server

Set up a Proxy Server (package:

plasticscm-proxy-server

) to improve performance when your team works across different network locations. The proxy runs on port 8085 and automatically creates a

plasticscm-proxy-server

system service for reliable operation.

Install a specific version

You can specify exact versions for each package in your installation command when you need a particular Unity Version Control version.

Note

We maintain recent versions of UVCS. Older versions might not be available through package installation.

You can also use the zip installer from the More installers section on our downloads page to downgrade if needed.

Debian

Set up and install UVCS on Debian.

Prerequisites

Debian 9 or higher
x64 architecture

Set up the repository

Add Unity Version Control's stable repository to access our latest long-term support releases:


sudo apt-get updatesudo apt-get install -y apt-transport-httpswget -qO - https://www.plasticscm.com/plasticrepo/stable/debian/Release.key | \  gpg --dearmor | sudo tee /usr/share/keyrings/plasticscm-stable.gpg > /dev/nullecho "deb [signed-by=/usr/share/keyrings/plasticscm-stable.gpg] \  https://www.plasticscm.com/plasticrepo/stable/debian ./" | \  sudo tee /etc/apt/sources.list.d/plasticscm-stable.listsudo apt-get update

Install Unity Version Control

Cloud Edition


sudo apt-get install plasticscm-cloud

Complete Installation


sudo apt-get install plasticscm-complete

DVCS Packages


sudo apt-get install plasticscm-dvcs

Proxy Server


sudo apt-get install plasticscm-proxy-server

Specific Version

Replace

11.0.16.7608

with your desired version:


sudo apt-get install \plasticscm-complete=11.0.16.7608 \plasticscm-server-complete=11.0.16.7608 \plasticscm-client-complete=11.0.16.7608 \plasticscm-client-core=11.0.16.7608 \plasticscm-client-gui=11.0.16.7608 \plasticscm-theme=11.0.16.7608 \plasticscm-server-core=11.0.16.7608

Ubuntu

Set up and install UVCS on Ubuntu.

Prerequisites

Ubuntu 15.04 or higher
x64 architecture

Set up the repository

Add Unity Version Control's stable repository to access our latest long-term support releases:


sudo apt-get updatesudo apt-get install -y apt-transport-httpswget -qO - https://www.plasticscm.com/plasticrepo/stable/ubuntu/Release.key | \  gpg --dearmor | sudo tee /usr/share/keyrings/plasticscm-stable.gpg > /dev/nullecho "deb [signed-by=/usr/share/keyrings/plasticscm-stable.gpg] \  https://www.plasticscm.com/plasticrepo/stable/ubuntu ./" | \  sudo tee /etc/apt/sources.list.d/plasticscm-stable.listsudo apt-get update

Install Unity Version Control

Cloud Edition


sudo apt-get install plasticscm-cloud

Complete Installation


sudo apt-get install plasticscm-complete

DVCS Packages


sudo apt-get install plasticscm-dvcs

Proxy Server


sudo apt-get install plasticscm-proxy-server

Specific Version

Replace

11.0.16.7608

with your desired version:


sudo apt-get install \plasticscm-complete=11.0.16.7608 \plasticscm-server-complete=11.0.16.7608 \plasticscm-client-complete=11.0.16.7608 \plasticscm-client-core=11.0.16.7608 \plasticscm-client-gui=11.0.16.7608 \plasticscm-theme=11.0.16.7608 \plasticscm-server-core=11.0.16.7608

Fedora

Set up and install UVCS on Fedora.

Prerequisites

Fedora 22 or higher
x64 architecture

Set up the repository

Add Unity Version Control's stable repository:


sudo dnf config-manager --add-repo \https://www.plasticscm.com/plasticrepo/stable/fedora/plasticscm-stable.repo

Install Unity Version Control

Tip

Enable automatic startup by running

systemctl enable plasticscm-server

after installation. This ensures your Unity Version Control server starts automatically when your system boots.

Cloud Edition


sudo dnf install plasticscm-cloud

Complete Installation


sudo dnf install plasticscm-complete

DVCS Packages


sudo dnf install plasticscm-dvcs

Proxy Server


sudo dnf install plasticscm-proxy-server

Tip

Enable automatic startup for the proxy by running

systemctl enable plasticscm-proxy-server

after installation.

Important

If you want to upgrade from an older proxy and you have

plasticscm-proxy-server-netcore

installed, remove it first to avoid conflicts:


sudo dnf remove plasticscm-proxy-server-netcoresudo dnf install plasticscm-proxy-server

Your configuration and data is preserved during this upgrade.

Specific Version

Replace

11.0.16.7608

with your desired version:


sudo dnf install \plasticscm-complete-11.0.16.7608-1.1 \plasticscm-server-complete-11.0.16.7608-1.1 \plasticscm-client-complete-11.0.16.7608-1.1 \plasticscm-client-core-11.0.16.7608-2.1 \plasticscm-client-gui-11.0.16.7608-1.1 \plasticscm-theme-11.0.16.7608-2.1 \plasticscm-server-core-11.0.16.7608-2.1

Red Hat / CentOS

Set up and install UVCS on Red Hat or CentOS.

Prerequisites

RedHat Enterprise Linux / CentOS 7.x or higher
x64 architecture

Set up the repository

Add Unity Version Control's stable repository:


sudo wget https://www.plasticscm.com/plasticrepo/stable/redhat/plasticscm-stable.repo \-O /etc/yum.repos.d/plasticscm-stable.repo

Install required dependencies

Unity Version Control needs the

lttng-ust

package to function properly. Get it from the Extra Packages for Enterprise Linux:


sudo yum install epel-release

Install Unity Version Control

Tip

Enable automatic startup by running

systemctl enable plasticscm-server

after installation. This ensures your Unity Version Control server starts automatically when your system boots.

Cloud Edition


sudo yum install plasticscm-cloud

Complete Installation


sudo yum install plasticscm-complete

DVCS Packages


sudo yum install plasticscm-dvcs

Proxy Server


sudo yum install plasticscm-proxy-server

Tip

To enable automatic startup for the proxy, run

systemctl enable plasticscm-proxy-server

after installation.

Important

If you want to upgrade from an older proxy and have

plasticscm-proxy-server-netcore

installed, remove it first to avoid conflicts:


sudo yum remove plasticscm-proxy-server-netcoresudo yum install plasticscm-proxy-server

Your configuration and data will be preserved during this upgrade.

Specific Version

Replace

11.0.16.7608

with your desired version:


sudo yum install \plasticscm-complete-11.0.16.7608-1.1 \plasticscm-server-complete-11.0.16.7608-1.1 \plasticscm-client-complete-11.0.16.7608-1.1 \plasticscm-client-core-11.0.16.7608-2.1 \plasticscm-client-gui-11.0.16.7608-1.1 \plasticscm-theme-11.0.16.7608-2.1 \plasticscm-server-core-11.0.16.7608-2.1

OpenSUSE

Set up and install UVCS on OpenSUSE.

Prerequisites

OpenSUSE 15.4 or higher
x64 architecture

Set up the repository

Add Unity Version Control's stable repository:


sudo zypper ar -f https://www.plasticscm.com/plasticrepo/stable/opensuse/ plasticscm-stablesudo zypper ref

Install Unity Version Control

Tip

Enable automatic startup by running

systemctl enable plasticscm-server

after installation. This ensures your Unity Version Control server starts automatically when your system boots.

Cloud Edition


sudo zypper install plasticscm-cloud

Complete Installation


sudo zypper install plasticscm-complete

DVCS Packages


sudo zypper install plasticscm-dvcs

Proxy Server


sudo zypper install plasticscm-proxy-server

Tip

To enable automatic startup for the proxy, run

systemctl enable plasticscm-proxy-server

after installation.

Important

If you want to upgrade from an older proxy and you have

plasticscm-proxy-server-netcore

installed, remove it first to avoid conflicts:


sudo zypper remove plasticscm-proxy-server-netcoresudo zypper install plasticscm-proxy-server

Your configuration and data is preserved during this upgrade.

Specific Version

Replace

11.0.16.7608

with your desired version:


sudo zypper install \plasticscm-complete-11.0.16.7608-1.1 \plasticscm-server-complete-11.0.16.7608-1.1 \plasticscm-client-complete-11.0.16.7608-1.1 \plasticscm-client-core-11.0.16.7608-2.1 \plasticscm-client-gui-11.0.16.7608-1.1 \plasticscm-theme-11.0.16.7608-2.1 \plasticscm-server-core-11.0.16.7608-2.1

Set up the Eclipse plug-in

To use Unity Version Control with Eclipse, follow these steps:

Find your Eclipse installation directory (this example uses
```
$ECLIPSE_ROOT
```
).
Run the following commands to install the plug-in:


rm -f $ECLIPSE_ROOT/plugins/com.codicesoftware.*.jarcp /opt/plasticscm5/client/eclipse_plugin/com.codicesoftware.*.jar $ECLIPSE_ROOT/plugins$ECLIPSE_ROOT/eclipse -clean

The

-clean

flag ensures Eclipse recognizes the new plug-in on startup.

Get help

Contact our support team if you need help with your Unity Version Control setup.