Stamus control

Description

stamusctl is a Command-Line Interface application written in GoLang by Stamus Networks that provides various functionalities to:

• manage Stamus stack configuration
• deploy Stamus stack

stamusd is a daemon that provides a REST API with functionalities similar to stamusctl. You can find its documentation here.

Installation

To install stamusctl, you can:

• build it from source
• get it from us wget https://dl.clearndr.io/stamusctl-linux-amd64
• get it from github wget https://github.com/StamusNetworks/stamusctl/releases/latest/download/stamusctl-linux-amd64

Examples

// Init via user prompt
stamusctl compose init

// Init default settings
stamusctl compose init suricata.interfaces=eth0

// Get current config
stamusctl config get

// Set parameter in current config
stamusctl config set suricata.interfaces=eth1

// Start current configuration
stamusctl compose up -d

// Read a pcap file
stamusctl compose readpcap /path/to/pcap

Installation details

wget https://dl.clearndr.io/stamusctl-linux-amd64
chmod +x stamusctl-linux-amd64
mv stamusctl-linux-amd64 /usr/local/bin/stamusctl

Build from source

git clone https://github.com/StamusNetworks/stamusctl.git

and follow golang documentation.

To build the stamusctl binary, you can:

STAMUS_APP_NAME=stamusctl go build -o ./stamusctl ./cmd

To build the stamusd binary, you can:

go build -o ./stamusd ./cmd

To build on Windows you can do:

make all CLI_NAME=stamusctl.exe DAEMON_NAME=./stamusd.exe CURRENT_DIR=. HOST_OS=windows HOST_ARCH=amd64 VERSION=$(cat VERSION) GIT_COMMIT=$(git rev-parse HEAD)

Usage

If you have the binary in your path, you can:

stamusctl [commands] [flags] [args]

If not, you can:

./stamusctl [commands] [flags] [args]

Commands

Compose

stamusctl compose is the command used to manage the containerized Stamus stack deployement.

• init is used to initiate configuration files
  • --config to select folder to save configuration
  • --values to use a values.yaml as configuration
  • --fromFile to use a file as value for a specific key
  • --apply to relaunch the configuration
  • [key]=[value] are the args to set configuration values (ex: suricata.interfaces=eth0)
• up to start current configuration
  • --file to select specific configuration
  • --detach to launch in detached mode
• down to stop current configuration
  • --file to select specific configuration
  • --volumes to remove named volumes
  • --remove-orphans to remove not defined containers
• update to update the configuration
  • --config to select folder
  • --registry to select registry
  • --user to input user
  • --pass to input password
  • --version to input version
• readpcap to read a pcap file
  • --config to select folder

Config

stamusctl config is the command used to manage the configuration files.

• config is used to modify configuration files
  • get to display the current configuration values
    • [key] to get specific configuration values (ex: scirius)
    • content to get configuration architecture
      • [key] to get specific configuration files (ex: nginx)
  • set to modify configuration
    • --reload to reset arbitrary values
    • --apply to relaunch the configuration
    • [key]=[value] to set configuration values (ex: suricata.interfaces=eth0)
    • content to set configuration files
      • [host folder]:[configuration folder] to set specific configuration files (ex: ./nginx:/nginx)

Login

stamusctl login is the command used to login to image registries. This way, you can pull images from private registries.

• login is used to login to image registries
  • --registry to select registry
  • --user to input user
  • --pass to input password

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

License

This project is licensed under the GPL3 License.