Things to check before starting up

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 doesn’t support Android Studio projects

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
      • Mac OS X 10.7 or later
      • Linux (based on our knowledge, any 64-bit distribution should do)
  2. As Upsource is a set of Java applications, it requires Java runtime to be installed. Upsource bundles JDK 1.8 for Windows and Mac OS X and you don’t have to explicitly install JDK if you’re going to run Upsource on one of these operating systems. However if you’re going to install Upsource on Linux, you should first install JRE 1.8 or JDK 1.8 for Linux.

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

    • On Linux or Mac OS, 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

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

  5. Upsource users should use a modern web browser. Upsource supports Internet Explorer 10+ and recent versions of Firefox, Chrome and Opera.