Installing Upsource on Linux

To help you install Upsource quickly and easily, let’s take a common Ubuntu installation as an example and go through the entire process.

First of all we need to install Java

  1. Unless you already have one, download JRE 1.8 installation package from the Oracle web-site.

  2. Launch the terminal and create a folder where java binaries will be stored:

    sudo mkdir –p /usr/local/java
  3. Go to the folder with the downloaded jre archive (the default location is shown here):

    cd /home/user_name/downloads
  4. Copy the archive to your java folder:

    sudo cp –r jre-7u25-linux-x64.tar.gz /usr/local/java
  5. Go to the java folder:

    cd /usr/local/java

To execute our archive, we need to set permissions.

  1. Change the permissions:

    sudo chmod a+x jre.tar.gz
  2. Unpack the archive:

    sudo tar xvzf jre.tar.gz

Now we are going to set system variables.

  1. Edit /etc/profile:

    sudo gedit /etc/profile

    and add the following lines to the bottom of the file:

    export JRE_HOME 
    export PATH

    Save the file and close it.

  2. Tell your system where JRE is located:

    sudo update-alternatives –install “/usr/bin/java” “java” “/usr/local/java/jre1.8.0_25” 1
  3. Make the JRE the default one:

    sudo update-alternatives –set java /usr/local/java/jre1.8.0_25/bin/java
  4. Check if java was installed correctly:

sh java -version

Next step is to adjust your system resource limits

Add the following lines to the /etc/security/limits.conf file:

* - memlock unlimited
* - nofile 100000
* - nproc 32768
* - as unlimited

Find a home for your Upsource dist

  1. Download a new Upsource build from our website.

  2. Create a folder for it. We’ll refer to this folder as Upsource home directory:

    Sudo mkdir –p /opt/Upsource
  3. Go to the folder with the downloaded Upsource archive (the default location is shown here):

    cd /home/user_name/downloads
  4. Copy the archive to your Upsource folder:

    cp /opt
  5. Set permissions:

    sudo chmod a+x
  6. Unpack the archive:

    sudo unzip
  7. Make the Upsource folder writable:

    sudo chmod -R a+rwX /opt/Upsource

Now we can start and configure Upsource.

  1. Launch the terminal and go to the bin folder in the Upsource home directory:

    cd /opt/Upsource/bin
  2. Run Upsource: start

When you run Upsource for the first time, it will open Configuration Wizard in your default browser, where you can specify initial settings.

That’s it. As soon as you’re finished, you’ll be taken to Upsource welcome page from where you can proceed to creating your first project.