ginstall.sh

ginstall.sh copied to clipboard

⚠ Warning ⚠

This project has reached EOL with the release of v3.4.1 and will be succeeded by a new script that was written from scratch soon™. This repository will be archived at that point.

About

This script can be used to install/update the compiled binaries of statically and dynamically linked applications from the command line.

It makes heavy use of gget under the hood to dynamically fetch git repository assets whenever possible.

Dependencies

Mandatory

• standard tools (bash, chmod, chown, grep, mv, rm, sed, tar)
• gget v0.5.2 or later
• curl
• unzip

Optional

• bzip2 (only required for installing restic)
• gzip (only required for installing chisel, cloud-torrent, goatcounter and govc)
• p7zip (only required for installing gobuster)
• sudo (only required for installing to /usr/local/bin)

Installation

You can install ginstall.sh by downloading the latest release to /usr/local/bin and making it executable:

sudo curl -L -o /usr/local/bin/ginstall.sh https://github.com/whalehub/ginstall.sh/releases/download/v3.4.1/ginstall.sh
sudo chmod +x /usr/local/bin/ginstall.sh

The dependency gget can be installed by running ginstall.sh with the --first-run flag.

Once gget has been installed, you can update it with ginstall.sh just like any other supported application.

Usage

whalehub@pdh:~# ginstall.sh --help
About:
  ginstall.sh is a script for installing/updating the compiled binaries of statically and dynamically linked applications.

Usage:
  ginstall.sh [flags] <app> <version>

Examples:
  ginstall.sh hugo 0.72.0
  ginstall.sh -d /opt/apps hugo latest
  ginstall.sh -d /opt/apps --first-run
  ginstall.sh -c hugo
  ginstall.sh -r hugo
  ginstall.sh -s hugo

Flags:
  --check, -c           Print the latest available version of an application
  --directory, -d       Specify a custom directory to use instead of /usr/local/bin
  --first-run           Install ginstall.sh's dependency gget via curl
  --remove, -r          Uninstall an application
  --search, -s          Perform a search on the list of supported applications
  --self-update         Update ginstall.sh to the latest available version

Info:
  --help, -h            Show this page
  --list, -l            Print a list of supported applications
  --version, -v         Print the ginstall.sh version information

API Rate Limits

The default rate limit for unauthenticated API requests on GitHub is 60 per hour per IP address. If required, you can increase this limit for your account to 5,000 per hour for free by generating a personal access token in your account settings and adding the following line to your user's .bashrc file.

export GITHUB_TOKEN=replace_this_string_with_your_token

Addition Requests

If you would like to see an application added to the list of supported ones, please feel free to either open an issue or a pull request.

Supported Applications

You can view a markdown-formatted version of the --list flag's output with easily-clickable repository links by opening the spoiler below.