Skip to content
/ cli Public

The universal installer and updater for (container) tools

License

Notifications You must be signed in to change notification settings

uniget-org/cli

Repository files navigation

OpenSSF Best Practices OpenSSF Scorecard

uniget

             _            _
 _   _ _ __ (_) __ _  ___| |_
| | | | '_ \| |/ _` |/ _ \ __|
| |_| | | | | | (_| |  __/ |_
 \__,_|_| |_|_|\__, |\___|\__|
               |___/

The universal installer and updater to (container) tools

⚠️ uniget is in the process of being migrated to GitLab. The migration is being tracked here. There is only one thing, you need to do: regularly update the uniget CLI using uniget self-update. ⚠️

Purpose

uniget is inspired by the convenience script to install the Docker daemon. But the scope is much larger.

uniget is meant to bootstrap a new box with Docker as well as install useful tools from the container ecosystem and beyond. It can also be used to update these tools. It aims to be distribution-agnostic and provide reasonable default configurations. Personally, I am using it to prepare virtual machines for my own experiments as well as training environments.

Tools are downloaded, installed and updated automatically.

Quickstart

Download and run uniget:

curl -sLf https://github.com/uniget-org/cli/releases/latest/download/uniget_linux_$(uname -m).tar.gz \
| sudo tar -xzC /usr/local/bin uniget

Docs

See the documentation site.

Quickstart

The uniget CLI comes with help included. The following scenarios are meant as quickstart tutorials.

You want the default set of tools

By default, uniget will only install a small set of tools.

uniget install --default

You want to investigate which tools are available

List which tools are available in uniget:

uniget list

You want to install a specific tool

It is possible to install individual tools:

uniget install gojq
uniget install kubectl helm

You want to search for tools

You can search for the specified term in names, tags and dependencies:

uniget search jq

You want to update installed tools

Updated tools which are already installed:

uniget update
uniget upgrade

You want to see what will happen

Show which tools will be processed and updated:

uniget install containerd --plan
uniget upgrade --plan

Reinstall tool(s)

By adding the --reinstall parameter, the selected tools can be reinstalled regardless if they are outdated:

uniget install gojq --reinstall