Skip to main content

Admin CLI

Use Katta Admin CLI to configure a Katta Server including its S3 storage backend.

Installation​

macOS (Homebrew)​

Requires Apple Silicon (arm64).

brew tap shift7-ch/katta
brew trust shift7-ch/katta
brew install katta

Upgrade with brew upgrade katta.

Linux (Debian/Ubuntu)​

curl -fsSLO https://github.com/shift7-ch/katta-admin-cli/releases/latest/download/katta_amd64.deb
sudo apt install ./katta_amd64.deb

Linux (Fedora/RHEL/openSUSE)​

sudo rpm -i https://github.com/shift7-ch/katta-admin-cli/releases/latest/download/katta.x86_64.rpm

The .deb and .rpm packages install katta to /usr/bin/katta and a bash completion script to /usr/share/bash-completion/completions/katta. They are built for x86_64/amd64 only.

Usage​

Use --help to print available commands.

katta --help
Usage: katta [-h] [-V] [COMMAND]
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.
Commands:
  setup           Setup Storage Provider Integration
  storageprofile  Configure Storage Location
  accesstoken     Get access token using authorization code flow.
  completion      Generate a bash completion script for the katta CLI.
  help            Display help information about the specified command.

Run --help on commands for the full option list:

katta storageprofile minio sts --help
katta storageprofile s3 static --help
Authentication

The storageprofile and accesstoken commands require the admin role. Make sure to log in with an admin user when prompted from the CLI to open the authorization URL.