minitrino 3.1.0

A command line tool that makes it easy to run modular Trino environments locally.

Minitrino

A command line tool that makes it easy to run modular Trino environments locally.

---

📘 Complete Documentation - User guides, API reference, and all 39 modules

---

Latest Stable Release: 3.1.0

What is Minitrino?

Minitrino lets you spin up complete Trino or Starburst clusters locally with minimal configuration. Mix and match from 39+ modules to create the exact environment you need:

• Catalogs: Hive, Iceberg, Delta Lake, Postgres, MySQL, ClickHouse, Elasticsearch, and more
• Security: LDAP, OAuth2, Kerberos, TLS, BIAC, password files
• Admin Tools: MinIO, Insights, Cache Service, Resource Groups, SCIM

Perfect for local development, testing configurations, learning features, and plugin development.

Compatibility

• Trino versions 443 and later
• Starburst Enterprise versions 443-e and later

Quick Start

Installation

pip install minitrino
minitrino lib-install

Run Your First Cluster

# Start a Trino cluster with Hive and Iceberg
minitrino -v provision -m hive -m iceberg

# Access the Trino UI at http://localhost:8080
# Or connect with the CLI
minitrino exec -i 'trino-cli'

Switch to Starburst

# Use Starburst with enterprise modules
minitrino -v provision -i starburst -m insights -m cache-service

Clean Up

minitrino down    # Stop the cluster
minitrino remove  # Remove all resources

Key Features

• 🎯 Zero Config - Start clusters with a single command
• 🔧 39+ Modules - Pre-configured catalogs, security, and admin tools
• 🐳 Docker-Based - Isolated containers, no system pollution
• 🔄 Multi-Cluster - Run multiple independent clusters simultaneously
• 🚀 Fast Setup - First provision ~5 min, subsequent provisions ~30 sec
• 📦 Both Distributions - Switch between Trino and Starburst with a flag

Development Setup

git clone https://github.com/jefflester/minitrino.git
cd minitrino
make install
source venv/bin/activate

This creates a virtual environment, installs the CLI in editable mode with dev dependencies, and sets up pre-commit hooks. See the Makefile for additional targets (pre-commit, unit-tests, integration-tests, lib-tests, docs).

Documentation

📘 Complete Documentation

Getting Started

• Installation & Upgrades
  • Install via PyPI, upgrade procedures, version compatibility
• Workflow Examples
  • Complete guide with provisioning, modules, and configuration
• CLI Reference
  • All commands, options, and flags
• Troubleshooting
  • Common issues and solutions

For Developers

• Build a Module
  • Step-by-step module creation guide
• Testing Guide
  • CLI and library test documentation
• GitHub Workflows
  • CI/CD and release process

Resources

• All Modules - Browse all 39 admin, catalog, and security modules
• Environment Variables & Config
  • Configuration hierarchy and customization
• API Reference - Python API documentation

Support & Community

• 📖 Documentation
• 🐛 Report Issues
• 💬 Trino Slack
• 🤝 Contributing Guide