Home

strut

Generic, installable CLI tool for managing Docker stacks on VPS infrastructure. Deploy, monitor, and operate any number of stacks from a single command line.

Version: 0.8.0 · License: See LICENSE · Language: Bash

---

Wiki Contents

Getting Started

• Installation — Install, upgrade, and uninstall strut
• Quick Start — Initialize a project, scaffold a stack, deploy

Core Concepts

• Architecture — How strut works: Strut_Home vs Project_Root, config loading, module system
• Configuration — strut.conf, services.conf, env files, per-stack config
• CLI Reference — Full command reference with examples
• Agent Steering — AI agent context: steering docs, operational skills, editor integration

Operations

• Deployment — Deploy, release, stop, update workflows
• Deploy Rollback — Automatic pre-deploy snapshots and one-command rollback
• Database Backups — Backup, restore, pull, push for Postgres, Neo4j, MySQL, SQLite
• Key Rotation — SSH keys, API keys, database passwords, GitHub secrets
• Drift Detection — Detect and fix configuration drift between git and VPS
• Domain and SSL — Custom domains, SSL certificates, nginx and Caddy support
• Monitoring — Prometheus, Grafana, Alertmanager setup and alert routing
• Volume Management — Dynamic volume management from volume.conf

Advanced

• VPS Audit and Migration — Audit existing VPS setups, migrate to strut management
• Stack Validation — Config schema validation and stack integrity checks
• Data Anonymization — PII protection when syncing production databases locally
• Debugging — Troubleshoot production issues, view logs, inspect containers
• Local Development — Local stack management, env sync, database sync

Contributing

• Contributing — Setup, testing, linting, code conventions
• Code Conventions — Shell module standards, function naming, error handling
• Adding a New Command — Step-by-step guide for extending the CLI
• Project Structure — File layout and module responsibilities