bastyn-cli

Command-line installer for BASTYN on-premises deployments.

Install

curl -sSL https://get.bastyn.ai/install.sh | bash

Or via pipx:

pipx install bastyn-cli

Usage

You will receive a license token from your BASTYN account representative.

bastyn init              # activate + configure + authenticate to image registry
bastyn up                # pull images and start all services
bastyn status            # show service health
bastyn logs              # tail logs (all services)
bastyn logs backend      # tail logs for one service
bastyn restart           # restart all services
bastyn restart backend   # restart one service
bastyn down              # stop all services (data preserved)
bastyn down --volumes    # stop and DELETE all data
bastyn upgrade           # pull new image versions and restart
bastyn rotate-key        # rotate registry credentials

Run bastyn COMMAND --help for details on any command.

What bastyn init does

1. Prompts for your license token
2. Contacts api.bastyn.ai to activate — provisions a dedicated, revocable image-pull credential for your organisation
3. Downloads the pinned deployment files (docker-compose.yml, .env.example, litellm_config.yaml, nginx.conf, README.md, serena_config.yml) into ./bastyn (or --install-dir)
4. Runs docker login against europe-west1-docker.pkg.dev
5. Walks you through each .env value — auto-generating secrets where possible, prompting for your LLM provider keys
6. Saves local state to ~/.bastyn/ (license token, install path)

Your LLM keys and admin credentials never leave your machine. The activation service only sees the license token and basic client info (OS, hostname) for audit logging.

Requirements

• Docker Desktop or Docker Engine + Compose plugin (v24+)
• Python 3.10+
• 4 CPU cores, 16 GB RAM, 50 GB disk
• Outbound HTTPS to api.bastyn.ai and europe-west1-docker.pkg.dev

See the bundled README.md inside your install directory for the full on-prem deployment guide.

Support

Contact your BASTYN account representative.