Urbalurba Infrastructure Documentation
Purpose: Master documentation index and entry point for Urbalurba Infrastructure Target Audience: All users, developers, and administrators
Overview
Welcome to the complete documentation for Urbalurba Infrastructure — a zero-friction developer platform that provides a complete datacenter environment on your laptop. This documentation covers everything from installation to advanced configuration and troubleshooting.
Quick Start
New to Urbalurba? Start here:
- Getting Started — 5-minute first test with your browser
- Installation Guide — Get up and running in 2 simple steps
- System Architecture — Understand how everything fits together
- Services Overview — See all available services vs Azure equivalents
Documentation Categories
Getting Started
Essential guides for new users and system administrators
| Document | Purpose |
|---|---|
| Getting Started | 5-minute first test guide with browser access |
| Installation Guide | Simple 2-step installation guide |
| System Architecture | Two-tier architecture overview with diagrams |
| Infrastructure Overview | Infrastructure components and relationships |
| Services Overview | Complete services comparison with Azure equivalents |
Services — Observability
Metrics, logs, and distributed tracing
| Document | Purpose |
|---|---|
| Observability Overview | Stack overview and architecture |
| Prometheus | Metrics collection and alerting |
| Grafana | Visualization and dashboards |
| Loki | Log aggregation |
| Tempo | Distributed tracing |
| OpenTelemetry Collector | Telemetry pipeline |
| OTLP Collector | OTLP ingestion configuration |
| sovdev-logger | Multi-language OTLP integration library |
Services — AI & ML
AI services, LLM integration, and model management
| Document | Purpose |
|---|---|
| AI & ML Overview | AI platform overview |
| Open WebUI | ChatGPT-like interface |
| LiteLLM | LLM proxy configuration |
| LiteLLM Client Keys | API key setup for Claude Code integration |
| OpenWebUI Model Access | Model access configuration |
| Environment Management | AI environment and model management |
Services — Analytics
Data science, notebooks, and distributed computing
| Document | Purpose |
|---|---|
| Analytics Overview | Analytics platform overview |
| Apache Spark | Distributed computing |
| JupyterHub | Collaborative notebooks |
| Unity Catalog | Data governance |
Services — Identity
SSO, authentication, and access control
| Document | Purpose |
|---|---|
| Identity Overview | Identity and access management overview |
| Authentik | Authentik SSO service |
| Auth10 Blueprints | Dynamic blueprint creation and management |
| Blueprints Syntax | Authentik blueprint configuration reference |
| Developer Guide | Auth10 developer guide |
| Technical Implementation | Authentik technical implementation details |
| Test Users | Test user configuration |
Services — Databases
Data storage and caching services
| Document | Purpose |
|---|---|
| Databases Overview | Database services overview |
| PostgreSQL | Primary relational database with AI/ML extensions |
| MySQL | Alternative SQL database |
| MongoDB | NoSQL document database |
| Redis | In-memory cache and message broker |
| Elasticsearch | Search and analytics engine |
| Qdrant | Vector database |
Services — Management
Admin tools, GitOps, and test services
| Document | Purpose |
|---|---|
| Management Overview | Management tools overview |
| ArgoCD | GitOps continuous deployment |
| pgAdmin | PostgreSQL administration UI |
| RedisInsight | Redis administration UI |
| Nginx | Web server |
| Whoami | Test/debug service |
| Dev Templates | Development templates and project setup |
Services — Integration
Messaging and API gateways
| Document | Purpose |
|---|---|
| Integration Overview | Integration services overview |
| RabbitMQ | Message broker |
| Gravitee | API management platform |
Services — Networking
VPN tunnels and network access services
| Document | Purpose |
|---|---|
| Networking Services Overview | Network services |
| Cloudflare Tunnel | Cloudflare tunnel service |
| Tailscale Tunnel | Tailscale tunnel service |
Networking
Network architecture, ingress, and external connectivity setup guides
| Document | Purpose |
|---|---|
| Networking Overview | Dual-tunnel internet access architecture |
| Cloudflare Setup | Cloudflare tunnel configuration guide |
| Tailscale Setup | Tailscale tunnel configuration guide |
| Tailscale Internal Ingress | Tailscale internal access setup |
| Tailscale Network Isolation | Tailscale funnel security setup |
Hosts & Platforms
Multi-environment deployment strategies and cloud platform integration
| Document | Purpose |
|---|---|
| Hosts Overview | Host types and deployment strategies |
| Rancher Kubernetes | Default local development environment |
| Azure AKS | Production Azure Kubernetes Service |
| Azure MicroK8s | Azure VM with MicroK8s |
| Multipass MicroK8s | Legacy Multipass deployment (superseded by Rancher) |
| Raspberry Pi MicroK8s | Edge computing on Raspberry Pi |
| Cloud-Init Guide | Cloud-init automation for Ubuntu-based hosts |
| Cloud-Init Secrets | SSH key setup for cloud-init and Ansible |
Provision Host
Central management container documentation
| Document | Purpose |
|---|---|
| Provision Host Overview | Central management container guide |
| Rancher Desktop | Rancher Desktop configuration |
Reference
Configuration, troubleshooting, and operational reference
| Document | Purpose |
|---|---|
| UIS CLI Reference | Complete UIS command-line reference |
| Service Dependencies | Service dependency graph |
| Factory Reset | Factory reset and full verification guide |
| Troubleshooting | Troubleshooting guide for common issues |
Contributors — Rules & Standards
Development guidelines, workflows, and architectural standards
| Document | Purpose |
|---|---|
| Rules Overview | Rules guide and index |
| UIS Deployment System | UIS CLI, service metadata, stacks, and deploy flow |
| Provisioning | Ansible playbook patterns and testing standards |
| Naming Conventions | File, resource, and identifier naming patterns |
| Ingress & Traefik | Traefik IngressRoute standards |
| Git Workflow | Git branching, commits, and PR standards |
| Secrets Management Rules | Secrets management rules |
| Development Workflow | Development workflow and command execution |
| Documentation Guide | Documentation standards |
Contributors — Architecture
Internal system design and implementation details
| Document | Purpose |
|---|---|
| Deploy System | Kubernetes-specific management tools |
| Tools Reference | Command reference and usage patterns |
| Kubernetes Manifests | Manifest file reference |
| Secrets Management System | Secrets management system documentation |
AI Development
Guides for contributors using AI-assisted development
| Document | Purpose |
|---|---|
| AI Developer Guide | Overview for AI coding assistants |
| Workflow | Workflow for AI-assisted contributions |
| Plans | Plan structure, templates, and best practices |
Finding What You Need
By Role
Developers:
- Start: Installation → Architecture → Provision Host
- AI Development: AI & ML Overview
- Authentication: Identity Overview
Infrastructure Engineers:
- Start: Architecture → Hosts
- Production: Azure AKS
- Networking: Traefik Rules
Architects:
- Start: Architecture → UIS Deployment System
- Security: Identity → Secrets Management
Data Scientists:
- Start: Analytics Overview
- AI/ML: AI Overview → LiteLLM
By Use Case
Getting Started:
- Installation Guide — Install and setup
- System Architecture — Understand the system
- Provision Host — Learn management tools
Setting Up Authentication:
- Identity Overview — Core SSO setup
- Auth10 Blueprints — Blueprint management
- Technical Implementation — Integration details
AI Development:
- AI & ML Overview — Platform overview
- LiteLLM — LLM proxy setup
- Open WebUI — Chat interface
Production Deployment:
- Hosts Overview — Deployment strategies
- Azure AKS — Azure production
- Networking Overview — External access
External Access:
- Cloudflare Setup — Cloudflare tunnels
- Tailscale Setup — VPN access
- Networking Overview — Network architecture
Getting Help
- Technical Issues: See Troubleshooting Guide
- Architecture Questions: Review System Architecture
- Bug Reports: Use GitHub issues in the main repository
- Contributions: Follow Git Workflow Rules
Documentation Standards
All documentation follows the standards defined in:
- Documentation Guide — Documentation writing standards
- Git Workflow Rules — Git workflow and contribution standards
Total Documentation: 92 pages (excluding internal plans) | Last Updated: March 2026