otto-stack Get started

Setup & Installation

📦 Installation

# 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:

# Download the latest release
curl -L -o otto-stack "https://github.com/otto-nation/otto-stack/releases/latest/download/otto-stack-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)"
chmod +x otto-stack
sudo mv otto-stack /usr/local/bin/

Windows: Download from releases page

Package Managers

Homebrew (macOS):

# Coming soon
brew install otto-nation/tap/otto-stack

🐳 Prerequisites

Docker

macOS:

# Option 1: Docker Desktop
# Download from https://docker.com

# Option 2: Colima (lightweight)
brew install colima docker
colima start

Linux:

# Install Docker Engine
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

Windows:

System Requirements

  • RAM: 4GB minimum, 8GB recommended
  • Disk: 2GB free space
  • CPU: Any modern processor

🚀 Quick Start

# Verify installation
otto-stack version

# Initialize new project
otto-stack init

# Start development environment
otto-stack up

# Check status
otto-stack status

⚙️ Configuration

Otto-stack creates configuration files during initialization:

Main config (.otto-stack/config.yaml):

project:
  name: my-app
  type: docker

stack:
  enabled:
    - postgres
    - redis

Environment variables (.env.generated):

Shows available configuration options with defaults:

POSTGRES_DB=${POSTGRES_DB:-local_dev}
POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-password}
REDIS_PASSWORD=${REDIS_PASSWORD:-password}

Create a .env file to customize:

POSTGRES_DB=my_custom_db
POSTGRES_PASSWORD=secure_password

See Configuration Guide for details.

🔧 Verification

# Check system health
otto-stack doctor

# Test Docker connectivity
docker info

# Verify services start
otto-stack up
otto-stack status

🧹 Uninstallation

# Remove otto-stack from your system
curl -fsSL https://raw.githubusercontent.com/otto-nation/otto-stack/main/scripts/uninstall.sh | bash

📚 Next Steps

🆘 Need Help?

Last updated on February 12, 2026
Edit this page on GitHub
Next
Configuration Guide