# Setup Quick Start - 5 Minutes to Deployment\n\n**Goal**: Get provisioning running in 5 minutes with a working example\n\n## Step 1: Check Prerequisites (30 seconds)\n\n```\n# Check Nushell\nnu --version   # Should be 0.109.0+\n\n# Check deployment tool\ndocker --version    # OR\nkubectl version     # OR\nssh -V              # OR\nsystemctl --version\n```\n\n## Step 2: Install Provisioning (1 minute)\n\n```\n# Option A: Using installer script\ncurl -sSL https://install.provisioning.dev | bash\n\n# Option B: From source\ngit clone https://github.com/project-provisioning/provisioning\ncd provisioning\n./scripts/install.sh\n```\n\n## Step 3: Initialize System (2 minutes)\n\n```\n# Run interactive setup\nprovisioning setup system --interactive\n\n# Follow the prompts:\n# - Press Enter for defaults\n# - Select your deployment tool\n# - Enter provider credentials (if using cloud)\n```\n\n## Step 4: Create Your First Workspace (1 minute)\n\n```\n# Create workspace\nprovisioning setup workspace myapp\n\n# Verify it was created\nprovisioning workspace list\n```\n\n## Step 5: Deploy Your First Server (1 minute)\n\n```\n# Activate workspace\nprovisioning workspace activate myapp\n\n# Check configuration\nprovisioning setup validate\n\n# Deploy server (dry-run first)\nprovisioning server create --check\n\n# Deploy for real\nprovisioning server create --yes\n```\n\n## Verify Everything Works\n\n```\n# Check health\nprovisioning platform health\n\n# Check servers\nprovisioning server list\n\n# SSH into server (if applicable)\nprovisioning server ssh <server-name>\n```\n\n## Common Commands Cheat Sheet\n\n```\n# Workspace management\nprovisioning workspace list              # List all workspaces\nprovisioning workspace activate prod     # Switch workspace\nprovisioning workspace create dev        # Create new workspace\n\n# Server management\nprovisioning server list                 # List servers\nprovisioning server create               # Create server\nprovisioning server delete <name>        # Delete server\nprovisioning server ssh <name>           # SSH into server\n\n# Configuration\nprovisioning setup validate              # Validate configuration\nprovisioning setup update platform       # Update platform settings\n\n# System info\nprovisioning info                        # System information\nprovisioning capability check            # Check capabilities\nprovisioning platform health             # Check platform health\n```\n\n## Troubleshooting Quick Fixes\n\n**Setup wizard won't start**\n\n```\n# Check Nushell\nnu --version\n\n# Check permissions\nchmod +x $(which provisioning)\n```\n\n**Configuration error**\n\n```\n# Validate configuration\nprovisioning setup validate --verbose\n\n# Check paths\nprovisioning info paths\n```\n\n**Deployment fails**\n\n```\n# Dry-run to see what would happen\nprovisioning server create --check\n\n# Check platform status\nprovisioning platform status\n```\n\n## What's Next\n\nAfter basic setup:\n\n1. **Configure Provider**: Add cloud provider credentials\n2. **Create More Workspaces**: Dev, staging, production\n3. **Deploy Services**: Web servers, databases, etc.\n4. **Set Up Monitoring**: Health checks, logging\n5. **Automate Deployments**: CI/CD integration\n\n## Need Help\n\n```\n# Get help\nprovisioning help\n\n# Setup help\nprovisioning help setup\n\n# Specific command help\nprovisioning <command> --help\n\n# View documentation\nprovisioning guide system-setup\n```\n\n## Key Files\n\nYour configuration is in:\n\n**macOS**: `~/Library/Application Support/provisioning/`\n**Linux**: `~/.config/provisioning/`\n\nImportant files:\n\n- `system.toml` - System configuration\n- `user_preferences.toml` - User settings\n- `workspaces/*/` - Workspace definitions\n\n---\n\n**Ready to dive deeper?** Check out the [Full Setup Guide](SETUP_SYSTEM_GUIDE.md)
