# Provisioning Platform - Quick Start\n\nFast deployment guide for all modes.\n\n---\n\n## Prerequisites\n\n```{$detected_lang}\n# Verify Docker is installed and running\ndocker --version  # 20.10+\ndocker-compose --version  # 2.0+\ndocker ps  # Should work without errors\n```\n\n---\n\n## 1. Solo Mode (Local Development)\n\n**Services**: Orchestrator, Control Center, CoreDNS, OCI Registry, Extension Registry\n\n**Resources**: 2 CPU cores, 4GB RAM, 20GB disk\n\n```{$detected_lang}\ncd /Users/Akasha/project-provisioning/provisioning/platform\n\n# Generate secrets\n./scripts/generate-secrets.nu\n\n# Deploy\n./scripts/deploy-platform.nu --mode solo\n\n# Verify\n./scripts/health-check.nu\n\n# Access\nopen http://localhost:8080  # Orchestrator\nopen http://localhost:8081  # Control Center\n```\n\n**Stop**:\n\n```{$detected_lang}\ndocker-compose down\n```\n\n---\n\n## 2. Multi-User Mode (Team Collaboration)\n\n**Services**: Solo + Gitea, PostgreSQL\n\n**Resources**: 4 CPU cores, 8GB RAM, 50GB disk\n\n```{$detected_lang}\ncd /Users/Akasha/project-provisioning/provisioning/platform\n\n# Generate secrets\n./scripts/generate-secrets.nu\n\n# Deploy\n./scripts/deploy-platform.nu --mode multi-user\n\n# Verify\n./scripts/health-check.nu\n\n# Access\nopen http://localhost:3000  # Gitea\nopen http://localhost:8081  # Control Center\n```\n\n**Configure Gitea**:\n\n1. Visit <http://localhost:3000>\n2. Complete initial setup wizard\n3. Create admin account\n\n---\n\n## 3. CI/CD Mode (Automated Pipelines)\n\n**Services**: Multi-User + API Server, Jenkins (optional), GitLab Runner (optional)\n\n**Resources**: 8 CPU cores, 16GB RAM, 100GB disk\n\n```{$detected_lang}\ncd /Users/Akasha/project-provisioning/provisioning/platform\n\n# Generate secrets\n./scripts/generate-secrets.nu\n\n# Deploy\n./scripts/deploy-platform.nu --mode cicd --build\n\n# Verify\n./scripts/health-check.nu\n\n# Access\nopen http://localhost:8083  # API Server\n```\n\n---\n\n## 4. Enterprise Mode (Production)\n\n**Services**: Full stack (15+ services)\n\n**Resources**: 16 CPU cores, 32GB RAM, 500GB disk\n\n```{$detected_lang}\ncd /Users/Akasha/project-provisioning/provisioning/platform\n\n# Generate production secrets\n./scripts/generate-secrets.nu --output .env.production\n\n# Review and customize\nnano .env.production\n\n# Deploy with build\n./scripts/deploy-platform.nu --mode enterprise \\n                              --env-file .env.production \\n                              --build \\n                              --wait 600\n\n# Verify\n./scripts/health-check.nu\n\n# Access\nopen http://localhost:3001  # Grafana (admin / password from .env)\nopen http://localhost:9090  # Prometheus\nopen http://localhost:5601  # Kibana\n```\n\n---\n\n## Common Commands\n\n### View Logs\n\n```{$detected_lang}\ndocker-compose logs -f\ndocker-compose logs -f orchestrator\ndocker-compose logs --tail=100 orchestrator\n```\n\n### Restart Services\n\n```{$detected_lang}\ndocker-compose restart orchestrator\ndocker-compose restart\n```\n\n### Update Platform\n\n```{$detected_lang}\ndocker-compose pull\n./scripts/deploy-platform.nu --mode <your-mode> --pull\n```\n\n### Stop Platform\n\n```{$detected_lang}\ndocker-compose down\n```\n\n### Clean Everything (WARNING: data loss)\n\n```{$detected_lang}\ndocker-compose down --volumes\n```\n\n---\n\n## Systemd (Linux Production)\n\n```{$detected_lang}\n# Install services\ncd systemd\nsudo ./install-services.sh\n\n# Enable and start\nsudo systemctl enable --now provisioning-platform\n\n# Check status\nsudo systemctl status provisioning-platform\n\n# View logs\nsudo journalctl -u provisioning-platform -f\n\n# Restart\nsudo systemctl restart provisioning-platform\n\n# Stop\nsudo systemctl stop provisioning-platform\n```\n\n---\n\n## Troubleshooting\n\n### Services not starting\n\n```{$detected_lang}\n# Check Docker\nsystemctl status docker\n\n# Check logs\ndocker-compose logs orchestrator\n\n# Check resources\ndocker stats\n```\n\n### Port conflicts\n\n```{$detected_lang}\n# Find what's using port\nlsof -i :8080\n\n# Change port in .env\nnano .env\n# Set ORCHESTRATOR_PORT=9080\n\n# Restart\ndocker-compose down && docker-compose up -d\n```\n\n### Health checks failing\n\n```{$detected_lang}\n# Check individual service\ncurl http://localhost:8080/health\n\n# Wait longer\n./scripts/deploy-platform.nu --wait 600\n\n# Check networks\ndocker network inspect provisioning-net\n```\n\n---\n\n## Access URLs\n\n### Solo Mode\n\n- Orchestrator: <http://localhost:8080>\n- Control Center: <http://localhost:8081>\n- OCI Registry: <http://localhost:5000>\n\n### Multi-User Mode\n\n- Gitea: <http://localhost:3000>\n- PostgreSQL: localhost:5432\n\n### CI/CD Mode\n\n- API Server: <http://localhost:8083>\n\n### Enterprise Mode\n\n- Prometheus: <http://localhost:9090>\n- Grafana: <http://localhost:3001>\n- Kibana: <http://localhost:5601>\n- Nginx: <http://localhost:80>\n\n---\n\n## Next Steps\n\n- **Full Guide**: See `docs/deployment/deployment-guide.md`\n- **Configuration**: Edit `.env` file for customization\n- **Monitoring**: Access Grafana dashboards (enterprise mode)\n- **API**: Use API Server for automation (CI/CD mode)\n\n---\n\n**Need Help?**\n\n- Health Check: `./scripts/health-check.nu`\n- Logs: `docker-compose logs -f`\n- Documentation: `docs/deployment/`
