Skip to main content

Installation

Getting started​

You can install the CLI with a curl utility script or by downloading the binary from the releases page. Once installed you'll get the komiser command.

Linux​

wget https://cli.komiser.io/3.0.1/linux/komiser

Windows​

wget https://cli.komiser.io/3.0.1/windows/komiser -O komiser.exe

Mac OS X​

For ARM architecture (M1 & M2 Chip)

wget https://cli.komiser.io/3.0.1/osx/arm/komiser

For AMD architecture (Intel Chip)

wget https://cli.komiser.io/3.0.1/osx/amd/komiser

Note Make sure to add the execution permission to Komiser chmod +x komiser.

Homebrew installation​

brew update
brew tap tailwarden/komiser
brew install komiser

How to use​

Komiser CLI installation​

Options​

Usage:
  komiser start [command]
Available Commands:
  config      Create configuration file
  help        Help about any command
  start       Run Komiser server
  version     Show tool version

Flags:
  -h, --help   help for komiser

Docker​

Komiser is also available as a Docker image:

https://hub.docker.com/r/tailwarden/komiser/tags/

Check Docker Hub of the Komiser changelog to find the latest version of Komiser.

Note: From Komiser v3 onwards, we natively support multiple cloud account authentication through the config.toml file, you will need to mount this fill along with a credentials file (not needed is using ENVIRONMENT_VARIABLES as the auth source) to the Docker container using the -v flags as seen in the Docker run command below. 

docker run -v /local/path/to/config.toml:/etc/config/config.toml  -v /local/path/to/credentials.yaml:/etc/config/credentials.yaml -d -p 3000:3000 --name komiser  tailwarden/komiser:3.0.1 komiser start --config /etc/config/config.toml

Docker installation tutorial​

Self-hosted​

Head over to your cloud provider of choice to learn how to connect your Komiser CLI to your cloud account and to deploy a self hosted version of the tool.