Skip to content

INSTALLATION.md

Latest commit

 

History

History
214 lines (140 loc) · 5.52 KB

INSTALLATION.md

File metadata and controls

214 lines (140 loc) · 5.52 KB

Installation

Package managers

Packaging status

macOS

The STACKIT CLI can be installed through the Homebrew package manager.

  1. First, you need to register the STACKIT tap via:
brew tap stackitcloud/tap
  1. You can then install the CLI via:
brew install --cask stackit

Linux

Snapcraft

The STACKIT CLI is available as a Snap, and can be installed via:

sudo snap install stackit --classic

or via the Snap Store for desktop.

Debian/Ubuntu (APT)

The STACKIT CLI can be installed through the APT package manager.

Before you begin

To install the STACKIT CLI package, you will need to have the curl and gnupg packages installed:

sudo apt-get update
sudo apt-get install curl gnupg
Installing
  1. Import the STACKIT public key:
curl https://packages.stackit.cloud/keys/key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/stackit.gpg
  1. Add the STACKIT CLI package repository as a package source:
echo "deb [signed-by=/usr/share/keyrings/stackit.gpg] https://packages.stackit.cloud/apt/cli stackit main" | sudo tee -a /etc/apt/sources.list.d/stackit.list
  1. Update repository information and install the stackit package:
sudo apt-get update
sudo apt-get install stackit

If you can't install the stackit package due to an expired key, please go back to step 1 to import the latest public key.

Nix / NixOS

The STACKIT CLI is available as a Nix package, and can be used via:

nix-shell -p stackit-cli

Eget

The STACKIT CLI binaries are available via our GitHub releases, you can install them from there using Eget.

# ~/.eget.toml
["stackitcloud/stackit-cli"]
asset_filters=["stackit-cli_", "_linux_amd64.tar.gz"]
eget stackitcloud/stackit-cli

RHEL/Fedora/Rocky/Alma/openSUSE/... (DNF/YUM/Zypper)

The STACKIT CLI can be installed through the DNF/YUM / Zypper package managers.

Requires rpm version 4.15 or newer to support Ed25519 signatures.

$basearch is supported by modern distributions. On older systems that don't expand $basearch, replace it in the baseurl with your architecture explicitly (for example, .../rpm/cli/x86_64 or .../rpm/cli/aarch64).

Installation via DNF/YUM
  1. Add the repository:
sudo tee /etc/yum.repos.d/stackit.repo > /dev/null << 'EOF'
[stackit]
name=STACKIT CLI
baseurl=https://packages.stackit.cloud/rpm/cli/$basearch
enabled=1
gpgcheck=1
gpgkey=https://packages.stackit.cloud/keys/key.gpg
EOF
  1. Install the CLI:
sudo dnf install stackit
Installation via Zypper
  1. Add the repository:
sudo tee /etc/zypp/repos.d/stackit.repo > /dev/null << 'EOF'
[stackit]
name=STACKIT CLI
baseurl=https://packages.stackit.cloud/rpm/cli/$basearch
enabled=1
gpgcheck=1
gpgkey=https://packages.stackit.cloud/keys/key.gpg
EOF
  1. Install the CLI:
sudo zypper install stackit

Any distribution

Alternatively, you can install via Homebrew or refer to one of the installation methods below.

We are currently working on distributing the CLI on more package managers for Linux.

Windows

Scoop

The STACKIT CLI can be installed through the Scoop package manager.

  1. Install Scoop (if not already installed):
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
  1. Install the CLI:
scoop install stackit

Manual installation

You can also get the STACKIT CLI by compiling it from source or downloading a pre-compiled binary.

Compile from source

  1. Clone the repository

  2. Build the application locally by running:

    make build

    To use the application from the root of the repository, you can run:

    ./bin/stackit <GROUP> <SUB-GROUP> <COMMAND> <ARGUMENT> <FLAGS>

  3. Skip building and run the Go application directly using:

    go run . <GROUP> <SUB-GROUP> <COMMAND> <ARGUMENT> <FLAGS>

FreeBSD

The STACKIT CLI can be installed through the FreeBSD ports or packages.

To install the port:

cd /usr/ports/sysutils/stackit/ && make install clean

To add the package, run one of these commands:

pkg install sysutils/stackit
# OR
pkg install stackit

Pre-compiled binary

  1. Download the binary corresponding to your operating system and CPU architecture from our Releases page
  2. Extract the contents of the file to your file system and move it to your preferred location (make sure the directory is added to your PATH)