Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity Version Control

DevOps

On-prem

Gluon

Editor plug-in

Open Unity Dashboard

Unity Version Control

​
​
Unity Version Control
  • Overview
  • Cloud Repositories organization update
  • Installation
  • Use UVCS with the Unity Editor
  • Unity Version Control plugins
  • Concepts
  • Tutorials
  • On-Prem
    • Server configuration
    • Client configuration
    • Manage On-Prem licenses
    • Stop, start, or restart server
    • Server administration console
    • Configure UVCS
      • Server configuration files
      • Configure lock rules
      • Merge rules
      • Configure file compression
      • Proxy servers
      • Use a proxy server
      • Support alternative connections to a server
      • Configure repository storage
    • Use server read-only mode
    • Back up and restore data
    • Archive revisions
    • Force client upgrades
    • SSL certificates
    • GitServer
    • Use SAML authentication with Microsoft Entra
  • Gluon
  • CLI and shortcut references
  • Release Notes
  1. Unity Version Control (previously Plastic SCM)

Support alternative connections to a server

Set up alias files for alternative connections to your server.
Read time 1 minute
Last updated 10 months 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
Note
The file can jump to a different URL and a different protocol (in this case from regular TCP to SSL).
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page

    • Configure the server aliases file

    • Example server alias file

Report a problem with this page