otto-stack

Setup

Wed, 01 Oct 2025 00:00:00 +0000

Setup & Installation

📦 Installation

Quick Install (Recommended)

# Install latest version
curl -fsSL https://raw.githubusercontent.com/otto-nation/otto-stack/main/scripts/install.sh | bash

Custom Installation

# Install to custom directory
curl -fsSL https://raw.githubusercontent.com/otto-nation/otto-stack/main/scripts/install.sh | bash -s -- --dir ~/.local/bin

Manual Installation

macOS/Linux:

Configuration Guide

Wed, 01 Oct 2025 00:00:00 +0000

Configuration Guide

Otto-stack uses .otto-stack/config.yaml to define your development stack.

Services

Wed, 01 Oct 2025 00:00:00 +0000

Available Services

13 services available for your development stack.

CLI Reference

Wed, 01 Oct 2025 00:00:00 +0000

otto-stack CLI Reference

A powerful development stack management tool for streamlined local development automation

Contributing

Wed, 01 Oct 2025 00:00:00 +0000

Contributing to otto-stack

Thank you for contributing! This guide covers the essentials to get you started.

Troubleshooting

Wed, 01 Oct 2025 00:00:00 +0000

Troubleshooting

🚨 Quick Fixes

Docker Issues

# Check if Docker is running
docker info

# Start Docker (macOS with Colima)
colima start

# Restart Docker services
otto-stack down && otto-stack up

Port Conflicts

# Find what's using a port
lsof -i :5432

# Kill process using port
kill -9 $(lsof -t -i:5432)

Service Won’t Start

# Check service logs
otto-stack logs postgres

# Restart specific service
otto-stack restart postgres

# Full reset
otto-stack down && otto-stack up

Configuration Issues

# Validate configuration
otto-stack doctor

# Debug mode
otto-stack --verbose up

🔍 Common Issues

“Docker not found”

Install Docker Desktop or Colima
Ensure Docker daemon is running
Check PATH includes Docker binaries

“Port already in use”

Another service is using the same port
Use lsof -i :PORT to identify the process
Either stop the conflicting service or change ports

“Service unhealthy”

Service failed health checks
Check logs with otto-stack logs SERVICE_NAME
Verify service configuration in YAML files

“Out of memory”

Increase Docker memory limits
Check docker stats for resource usage
Consider reducing number of running services

📞 Getting Help

Check logs: otto-stack logs SERVICE_NAME
Run diagnostics: otto-stack doctor
Search issues: GitHub Issues
Ask questions: GitHub Issues

🧹 Reset Everything

If all else fails:

Version Management System

Wed, 01 Oct 2025 00:00:00 +0000

Version Management System

The otto-stack version management system allows you to install, manage, and automatically switch between different versions of otto-stack based on project requirements.