Skip to main content

Generic Software Installation

This guide is provided for your convenience. The guide is provided as-is and may not be updated or maintained by Ultra.cc. Unofficial support may be offered via Discord only and at the sole discretion of Ultra.cc staff. Use at your own risk and only proceed if you are comfortable troubleshooting on your own.

In this guide, we will go over some generic ways of installing custom third party applications on your Ultra.cc service.

There are a lot of applications that can be installed with a click of a button on the User Control Panel. However, if you want to install an application that is not included on the UCP, you are free to do so. As long as you adhere to the Terms of Service and do not break the Fair Usage Policy, you are free to install pretty much any kind of software on your Ultra.cc service.

Important information regarding installation of custom third-party applications, do note:

  • You cannot install an application that requires sudo or root privileges.
  • Be mindful of application resource usage and IO utilization. See this guide.
  • Custom third party applications are not officially supported by Ultra.cc staff.
  • Always read the documentation associated with the software you are installing.

Before proceeding with the installation procedure, you need to connect to your Ultra.cc service via SSH.

  • Connect to your Ultra.cc slot via SSH, see guide here.

Compile from source

Below you will find generic instructions for how to compile from source. Some applications have specific instructions or required dependencies, so make sure to always check the documentation or website of the application you are installing.

  • Download the source. Files can be downloaded using a wide range of utility tools, such as wget, curl, git, etc.
wget https://example-url.com/appname-1.23.tar.gz
  • Extract the source.
tar xvzf appname-1.23.tar.gz
  • Navigate into the extracted directory
cd appname-1.23
  • Configure the application. See app specific documentation for additional configurations.
./configure --prefix="$HOME/bin && make"
  • Install the software
make install
  • Add install directory to path to enable global execution of the application.
echo "PATH=$HOME/.local/bin:$HOME/bin:$PATH" >> ~/.profile && source ~/.profile

Pre-built binaries

Some software can be available as pre-compiled binaries and do not have to be built within your Ultra.cc service.

  • Download the binary.
wget https://example-url.com/appname-1.23.tar.gz
  • Extract the binary.
tar xvzf appname-1.23.tar.gz
  • Move the binary to a directory within your shell environment PATH.
mv appname ~/bin/

Once the binary has been moved to a directory within your shell environment PATH, you can run the application by executing the filename of the binary. With the name example we are using in this guide, it would look like this: appname

Cloning a repo

Application software can also be installed by cloning a repository. The most popular repository library is GitHub, but there are also others like GitLab for example.

  • While in the GitHub repository, in the top right corner, click the green button called Code.

  • Copy the URL for the repository, as shown in the above image.
  • Change the current working directory of your Ultra.cc shell to the location where you want to clone the repo. This is usually the root of your home directory.
cd ~/
  • Clone the repo. Do note, AUTHOR and EXAMPLE-REPO would be replaced with what matches the repo you are cloning.
git clone https://github.com/AUTHOR/EXAMPLE-REPO
  • Next, cd into the cloned repo. Do note, EXAMPLE-REPO would be replaced with what matches the repo you are cloning.
cd EXAMPLE-REPO

Inside the cloned repo directory, you will find all the files of the repository, and you are free to execute any scripts or binaries that are included.

Back to top