prvng_platform/docs/guides/quick-start.md

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\nServices: Orchestrator, Control Center, CoreDNS, OCI Registry, Extension Registry\n\nResources: 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\nStop:\n\n{$detected_lang}\ndocker-compose down\n\n\n---\n\n## 2. Multi-User Mode (Team Collaboration)\n\nServices: Solo + Gitea, PostgreSQL\n\nResources: 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\nConfigure 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\nServices: Multi-User + API Server, Jenkins (optional), GitLab Runner (optional)\n\nResources: 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\nServices: Full stack (15+ services)\n\nResources: 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\nNeed Help?\n\n- Health Check: ./scripts/health-check.nu\n- Logs: docker-compose logs -f\n- Documentation: docs/deployment/