Upsource 2020.1 Help


Before you proceed to install Upsource, please make sure to...

Check your team's demands and expectations

  • Upsource is the right tool for you if your development team is looking for ways to browse different revisions of the code base without checking them out to local machines, and to discuss and review changes made in the code base.

  • Upsource only recognises changes that are committed to your repository.

  • Upsource can be used with any kind of projects and languages, however its static analysis only works for Java, JavaScript, and Kotlin projects that use IntelliJ IDEA, Maven, or Gradle as their build system. PHP and Python are also supported if installed on the Upsource server machine.

Check your hardware and software

  1. Since Upsource is an on-premises application, you should have a server to deploy Upsource to, and the server should:

    • Have 8 GB of RAM or more

    • Run one of the following 64-bit operating systems:

      • Windows Vista or later

      • macOS 10.7 or later

      • Linux (based on our knowledge, any 64-bit distribution should do)

    • Have enough disk space to accommodate your projects. Upsource maps the entire VCS into its internal database and hosts the following:

      • VCS data with commits graph and all files contents

      • Code review data (including discussions and timeline data)

      • IntelliJ IDEA indices for those projects, where IDEA can provide code insight

      So the actual required disk space depends on your repository size, number of files that support IDEA intelligence, and your team workflow (number of commits, reviews, discussions per day). It can vary from 3X to 70X of your VCS data size.

  2. Your fully qualified hostname should be resolvable to your IP address. To check it:

    • On Linux or macOS, run the following command:

      ping $(hostname -f)

    • On Windows, to get fully qualified hostname, run:

      ipconfig /all

    then try to ping that name (it should look like

  3. Your development team should use Git, Mercurial, Subversion, or Perforce for version control.

  4. Upsource users should use a modern web browser. Upsource supports recent versions of:

    • Firefox

    • Chrome

    • Safari

    • Edge

    • Opera

After you've checked your hardware and software, you can proceed to install and configure Upsource — read the instruction corresponding to your preferred installation type:

Last modified: 02 April 2021