Upsource Web Help

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.

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 (running Upsource on Windows is currently not recommended due to unresolved issues with Apache Cassandra, the database that Upsource bundles by default.)
      • 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.7 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.7 or JDK 1.7 for Linux.

    Please note that if you expect to use Upsource with Java projects compiled against a JDK version greater than JDK 1.7 (1.8 for instance), you should install and import that version explicitly, regardless of the platform:

    • Download and install a corresponding JDK from the Oracle website.

    • Install and start Upsource.

    • Run the following two commands in the given order:

      • Windows:

        import-jdk "1.8" <path-to-installed-jdk>/jre
      • Linux or Mac OS:

        import-jdk "1.8" <path-to-installed-jdk>/jre

      (Replace “1.8” with your actual JDK version)

  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.