msting CLI Reference
msting is the primary management interface for STING. It’s installed at /usr/local/bin/msting and wraps the modular manage_sting.sh script. All commands require sudo.
sudo msting <command> [options]
Service Management
start
Start all services or a specific service.
sudo msting start # Start all services
sudo msting start app # Start a specific service
sudo msting start frontend # Start frontend only
stop
Stop all services or a specific service.
sudo msting stop # Stop all services
sudo msting stop app # Stop a specific service
restart
Restart one or more services.
sudo msting restart # Restart all
sudo msting restart app # Restart one service
sudo msting restart app frontend knowledge # Restart multiple
recreate
Force-recreate containers with guaranteed environment reload. Use when env files have changed.
sudo msting recreate app # Recreate one service
sudo msting recreate app frontend # Recreate multiple
sudo msting recreate --cascade db # Recreate all services sharing a credential type
status
Show service health and system overview.
sudo msting status # Quick health overview
sudo msting status -v # Verbose diagnostics with resource usage
validate
Verify that container environment variables match the env files on disk.
sudo msting validate # Validate all services
sudo msting validate app # Validate a specific service
logs
Tail service logs.
sudo msting logs # All service logs
sudo msting logs app # Specific service
sudo msting logs app --tail 100 # Last 100 lines
Build & Update
build
Build Docker images from source.
sudo msting build # Build all images
sudo msting build app # Build a specific service
sudo msting build -q # Quiet mode
sudo msting build -v # Verbose mode
update
No-cache build plus restart. The safe way to deploy code changes.
sudo msting update app # Update a specific service
sudo msting update all # Update everything
sudo msting update --sync-only # Frontend code sync without rebuild
sudo msting update --nightly # Pull latest from GitHub + update
Important
Always usesudo msting update <service> to deploy changes. Never use rsync --delete to copy code to /opt/sting-ce/ — this can destroy runtime data including backups.cache-buzz
Clear build caches and rebuild. Named after the bee buzzing dance that shakes off debris.
sudo msting cache-buzz # Moderate cache clear + rebuild
sudo msting cache-buzz --full # Nuclear: remove all STING containers/images
sudo msting cache-buzz app # Cache clear + rebuild single service
Configuration
sync-config
Sync configuration files from the repo without rebuilding containers.
sudo msting sync-config
regenerate-env
Regenerate all environment files from config.yml. This reads the master config, resolves Vault secrets, and writes each service’s .env file.
sudo msting regenerate-env
reset-config
Reset config.yml from the template. Keeps 5 rolling backups.
sudo msting reset-config
vault-secret
Manage API keys and secrets stored in HashiCorp Vault.
sudo msting vault-secret list # List stored providers
sudo msting vault-secret openai <key> # Store an OpenAI API key
sudo msting vault-secret minimax <key> # Store a MiniMax API key
unseal
Unseal HashiCorp Vault if it’s sealed (e.g., after a restart).
sudo msting unseal
Database
migrate
Run database migrations.
sudo msting migrate # Run pending migrations
sudo msting migrate --all # Re-run all migrations (idempotent)
sudo msting migrate --status # Show migration status
User Management
create
Create admin or user accounts.
sudo msting create admin --email=admin@example.com
sudo msting create user user@example.com --role=moderator
delete
Delete user accounts.
sudo msting delete admin --email=admin@example.com
reset-mfa
Reset multi-factor authentication credentials for a user.
sudo msting reset-mfa --email=user@example.com
Maintenance
maintenance
Enable or disable maintenance mode with an optional message and duration.
sudo msting maintenance on -m "Scheduled update" -d 30 # Enable for 30 minutes
sudo msting maintenance off # Disable
backup
Create a full system backup, optionally encrypted.
sudo msting backup # Standard backup
sudo msting backup --encrypt # Encrypted backup
restore
Restore from a backup file.
sudo msting restore /path/to/backup.tar.gz
SSL & Certificates
setup-ssl
Configure Let’s Encrypt SSL certificates.
sudo msting setup-ssl example.com admin@example.com
renew-ssl
Renew SSL certificates.
sudo msting renew-ssl
ssl-status
Check certificate expiry dates.
sudo msting ssl-status
export-certs / copy-certs
Export or copy mkcert CA certificates for development.
sudo msting export-certs # Export to local dir
sudo msting copy-certs user@host /path # SCP to remote host
Diagnostics
debug
Run comprehensive system diagnostics.
sudo msting debug # Full diagnostics
sudo msting debug --plain # Plain text output (no colors)
buzz collect
Create a sanitized diagnostic bundle for support.
sudo msting buzz collect --hours 24 # Collect last 24 hours
bee support
AI-guided support ticket creation.
sudo msting bee support create "Description of the issue"
Other Commands
install
Install msting system-wide at /usr/local/bin/msting.
sudo msting install
reinstall
Reinstall STING with atomic backup and restore.
sudo msting reinstall # Standard reinstall
sudo msting reinstall --fresh # Fresh install (no data restore)
upload-knowledge
Upload platform documentation to a Honey Jar for Bee AI to reference.
sudo msting upload-knowledge # Upload docs
sudo msting upload-knowledge --update # Update existing
volumes
Manage Docker volumes.
sudo msting volumes list # List volumes with safety classification
encryption-keys
Check encryption key health.
sudo msting encryption-keys status