Documentation

Support

Unity Version Control

DevOps

On-prem

Gluon

Editor plug-in

Open Unity Dashboard

Unity Version Control

Support alternative connections to a server

Set up alias files for alternative connections to your server.
Read time 1 minuteLast updated 21 days ago
Use Unity Version Control (UVCS) to connect to the same server with different IP addresses and protocols. For example, if you connect to 
localserver.office-network.com:8084
at your office, but want to go home and connect through the public SSL-protected IP 
ssl://plastic.external-network.com:8090
, you can tell the client that 
server:8084
and 
ssl://externalserver:8085
are aliases of each other.

Configure the server aliases file

Use the 
serveralias.conf
file to enable this feature on your UVCS client so that the client knows which connection to use and can switch from one server URL to the other transparently. Create the 
serveralias.conf
file under one of the following directories:
  • On Linux or macOS: 
    $HOME/.plastic4
  • On Windows: 
    C:\Users\user\AppData\Local\plastic4
  • In the 
    plastic-global-config
    repository to give all clients the same settings by default.
  • Under the 
    client
    folder in the UVCS installation directory.
The 
serveralias.conf
file contains a pair of connections that are aliases of each other: 
alias1 alias2

Example server alias file

To resolve the example in the first paragraph, you can use the following 
serveralias.conf
file: 
localserver.office-network.com:8084 ssl://plastic.external-network.com:8090