Installing Software

Guidelines

  • Software that negatively impacts other users by burdening the server is not allowed.
  • You can't install software that requires root privileges.
  • Software that uses Java is specifically forbidden. We actively avoid Oracle software and Java in particular can be a resource hog.
  • Mining applications (Bitcoin, Litecoin, etc) are explicitly prohibited.
  • Tor nodes are not allowed as a result of the amount of spam that gets sent through them.

If you have any questions about whether something is allowed or run into any problem, put in a support ticket or come to IRC.

Compiling from source

Note: You will need to check the software's documentation on its website or in the README/INSTALL files in the source archive for any specific instructions and required dependencies.

These are generic instructions that, when edited, work for many software packages distributed as source code.

  1. Download the source

     wget https://www.site.com/software-1.11.tar.gz
    
  2. Extract the source. Most sources will be *.gz, but tar can also extract *.bz2 and *.xz

     tar xvf software-1.11.tar.gz
    
  3. Enter the source directory

     cd software-1.11
    
  4. Configure the installation. The most basic command is shown, but you may add any options you found in the documentation.

     ./configure --prefix=$HOME
    
  5. Compile the software

     make
    
  6. Install the software

     make install
    
  7. Add the ~/bin directory to your path. This will allow programs installed to $HOME to work without needing to type a full path.

     echo "PATH=\$HOME/bin:\$PATH" >> ~/.bashrc && source ~/.bashrc
    
  8. (Optional) Clean up the setup files

     cd ..
     rm software-1.11.tar.gz
     rm -r software-1.11
    

Pre-built binaries

Note: You should check the software's documentation on its website or in the README/INSTALL files in the binary archive for any specific instructions and required dependencies.

Some software has packages that are already compiled for you. You only need to extract and run the software.

  1. Download the source

     wget https://www.site.com/software-1.11.tar.gz
    
  2. Extract the source. Most sources will be *.gz, but below are examples of some other archive types you may encounter.

     tar xvzf software-1.11.tar.gz
     tar xvjf software-1.11.tar.bz2
     tar xvJf software-1.11.tar.xz
    
  3. Run the software as the documentation instructs

  4. (Optional) Clean up the setup files

     rm software-1.11.tar.gz
    

Python scripts

Note: You should check the script's documentation on its website or in the README/INSTALL files that come with the script for any specific instructions and required dependencies.

Many Python scripts require 3rd-party packages to work. Users can't install these globally. See the Python article for ways to install Python packages.