Upsource 2020.1 Help

Things to configure after the first start

When you run Upsource for the first time, it will open Configuration Wizard in your default browser. Select Set up:


First you need to choose what type of connection your Upsource server will provide:

  • For a basic unencrypted connection choose HTTP.

  • For a secure encrypted connection choose HTTPS. You will need to provide:

    • Private key

    • Certificate that contains your domain name.

    • Certificate that contains a trusted chain without your domain name.

    by clicking the Private key and certificate tab and uploading the data.

    Instead of entering your private key/certificate data directly, you can optionally generate a keystore file that will contain the data. Then click Key Store, and specify the path to the keystore file and its credentials.

Upsource accepts certificate data in the following formats:

  • keystore: JKS, PKCS#12

  • certificate/private key: PKCS#1, PKCS#8

Read more about certificates.


Next you can specify System settings:

  • Base URL—the URL at which the Upsource service will be available to the users. You might want to change the default value if:

    • your server has several DNS interfaces and you wish to make Upsource accessible by a particular DNS interface;

    • you have set up Upsource to work behind reverse or terminating HTTP proxy (see Proxy configuration)—in this case the new value should match the base URL you've set before.

  • Application Listen Port— you can change the default port that Upsource will use for HTTP or HTTPS communications if the suggested port is or expected to be taken.

    If you've selected a secure HTTPS mode, you can optionally set up a Redirect listen port—a non-secure port that will receive all HTTP requests and redirect them to the secure Application Listen Port you've specified.

  • Location of system directories (Under Advanced Settings)

Click Next to proceed to User management settings.


Here you have to choose to set up Upsource with either built-in Hub or external (standalone) Hub. If you are going to integrate with the YouTrack issue tracker or TeamCity, you should choose External Hub. Otherwise you may choose Build-in Hub.

If you are going to select External Hub:

  • Important: Prior to selecting External Hub, you should first install and start your external Hub service.

  • Select External Hub

  • Enter your Hub URL and verify the connection.

If Built-in Hub selected:

  • Create admin login and password—specify login name and password for your administrator account (Login: admin is offered by default). You'll be able to reset your password if you ever forget it.

  • Enable login as guest—allow guest (non-registered) users to access projects. You'll be able change guest user rights or deny anonymous access altogether later.


If you have a paid license, enter the license name and key. Click Finish when you're done.

Wait a little for Upsource to launch its components:


As soon as it's done, it will open its welcome page (http://your-host-name:port_for_upsource) which will also be opened upon any consequent startup:

Last modified: 02 April 2021