Skip to main content

Platform URLs and Ports Reference

Complete reference for all local development and production URLs in the LLM Platform ecosystem.

Overview​

The LLM Platform uses a comprehensive service-oriented architecture with clear separation between:

  • Local Development: DDEV/Docker-based services for development
  • Production: Kubernetes-deployed services under llm.bluefly.io domain
  • Service Management: alternative_services Drupal module for centralized configuration

Local Development URLs​

Core Platform​

ServiceURLDescription
Main Drupal Sitehttps://llm-platform.ddev.sitePrimary platform interface
Database127.0.0.1:32793MariaDB 10.11 (DDEV dynamic port)
Mailpithttps://llm-platform.ddev.site:8026Email testing interface

AI Services​

ServiceURLHealth CheckDescription
Ollamahttp://localhost:11434/api/tagsLocal LLM server
Ollama Clusterhttp://localhost:3001/healthLoad-balanced Ollama cluster
Model Registryhttp://localhost:8000/healthAI model management

Vector Database​

ServiceURLPurpose
Qdrant HTTPhttp://localhost:6333Vector database API
Qdrant Dashboardhttp://localhost:6333/dashboardVector database UI
Qdrant Metricshttp://localhost:6333/metricsPrometheus metrics
Qdrant gRPClocalhost:6334High-performance gRPC interface

Monitoring & Analytics​

ServiceURLPurpose
Grafanahttp://localhost:3000Monitoring dashboards
Prometheushttp://localhost:9090Metrics collection
MLflowhttp://localhost:5000ML experiment tracking

Storage & Infrastructure​

ServiceURLPurpose
MinIO APIhttp://localhost:9000S3-compatible storage
MinIO Consolehttp://localhost:9001Storage management UI

Application Services​

ServiceURLPurpose
LLM Gatewayhttp://localhost:8080API gateway
MCP Server HTTPhttp://localhost:3001Model Context Protocol
MCP Server WebSocketws://localhost:3002MCP WebSocket transport

Production URLs (llm.bluefly.io)​

Domain Structure​

llm.bluefly.io/
├── ai.llm.bluefly.io          # Ollama Cluster
├── api.llm.bluefly.io         # LLM Gateway
├── mcp.llm.bluefly.io         # MCP Server
├── vector.llm.bluefly.io      # Qdrant Database
├── monitoring.llm.bluefly.io  # Grafana
├── metrics.llm.bluefly.io     # Prometheus
├── mlflow.llm.bluefly.io      # MLflow
├── models.llm.bluefly.io      # Model Registry
├── storage.llm.bluefly.io     # MinIO
├── vault.llm.bluefly.io       # HashiCorp Vault
├── security.llm.bluefly.io    # Security Dashboard
├── ml.llm.bluefly.io          # Seldon Core
└── docker.llm.bluefly.io      # Docker Intelligence

Core Platform​

ServiceProduction URLLocal Equivalent
Main Platformhttps://llm.bluefly.iohttps://llm-platform.ddev.site
Admin Interfacehttps://admin.llm.bluefly.iohttps://llm-platform.ddev.site/admin

AI Services​

ServiceProduction URLLocal PortDescription
Ollama Clusterhttps://ai.llm.bluefly.io11434AI model inference
Model Registryhttps://models.llm.bluefly.io8000Model management
LLM Gatewayhttps://api.llm.bluefly.io8080API gateway
MCP Serverhttps://mcp.llm.bluefly.io3001/3002Model Context Protocol

Vector Database​

ServiceProduction URLLocal PortDescription
Qdranthttps://vector.llm.bluefly.io6333Vector database
Qdrant Dashboardhttps://vector-ui.llm.bluefly.io6333/dashboardVector database UI

Monitoring & Analytics​

ServiceProduction URLLocal PortDescription
Grafanahttps://monitoring.llm.bluefly.io3000Dashboards
Prometheushttps://metrics.llm.bluefly.io9090Metrics
MLflowhttps://mlflow.llm.bluefly.io5000ML tracking

Storage & Infrastructure​

ServiceProduction URLLocal PortDescription
MinIOhttps://storage.llm.bluefly.io9000Object storage
Vaulthttps://vault.llm.bluefly.io8200Secrets management
Security Dashboardhttps://security.llm.bluefly.io8080Security monitoring

Machine Learning​

ServiceProduction URLLocal PortDescription
Seldon Corehttps://ml.llm.bluefly.io8080ML platform
Docker Intelligencehttps://docker.llm.bluefly.io8090Container analytics

Service Management​

Alternative Services Module​

The alternative_services Drupal module provides centralized management of all services:

Key Management Paths​

  • Dashboard: /admin/config/alternative_services
  • Service Browser: /admin/config/alternative_services/browse
  • Health Monitor: /admin/reports/alternative_services/health
  • Discovery Settings: /admin/config/alternative_services/discovery

Features​

  • Automatic Service Discovery: Detects Docker/Kubernetes services
  • Health Monitoring: 30-second health checks
  • Configuration Management: YAML-based service definitions
  • DDEV Integration: Seamless local development
  • Production Mapping: Kubernetes service discovery

Service Configuration Examples​

Ollama Service Configuration​

id: ollama
label: 'Ollama LLM Server'
endpoint: 'http://localhost:11434'
service_type: ai_provider
port: 11434
health_endpoints:
  primary: 'http://localhost:11434/api/tags'
  version: 'http://localhost:11434/api/version'
settings:
  default_model: 'llama3.2:7b'
  embedding_model: 'nomic-embed-text'

Qdrant Service Configuration​

id: qdrant
label: 'Qdrant Vector Database'
endpoint: 'http://localhost:6333'
service_type: vector_db
port: 6333
additional_ports:
  grpc: 6334
  p2p: 6335
health_endpoints:
  primary: 'http://localhost:6333/health'
  dashboard: 'http://localhost:6333/dashboard'

Port Summary Table​

ServiceLocal PortProduction URLService Type
Drupal PlatformDDEV dynamicllm.bluefly.ioPlatform
Ollama11434ai.llm.bluefly.ioAI Provider
Ollama Cluster3001ai.llm.bluefly.ioLoad Balancer
Qdrant HTTP6333vector.llm.bluefly.ioVector DB
Qdrant gRPC6334vector.llm.bluefly.io:6334Vector DB
Grafana3000monitoring.llm.bluefly.ioMonitoring
Prometheus9090metrics.llm.bluefly.ioMetrics
MLflow5000mlflow.llm.bluefly.ioML Tracking
MinIO API9000storage.llm.bluefly.ioStorage
MinIO Console9001storage-ui.llm.bluefly.ioStorage UI
Model Registry8000models.llm.bluefly.ioModel Mgmt
LLM Gateway8080api.llm.bluefly.ioAPI Gateway
MCP HTTP3001mcp.llm.bluefly.ioProtocol
MCP WebSocket3002mcp.llm.bluefly.io:3002Protocol
Vault8200vault.llm.bluefly.ioSecurity

Environment Variables​

DDEV Environment​

  • DDEV_PRIMARY_URL: Primary site URL
  • DDEV_HOSTNAME: Current hostname
  • DDEV_WEBSERVER_TYPE: Web server type
  • DDEV_DATABASE: Database connection
  • DDEV_PHP_VERSION: PHP version

Production Environment​

  • KUBERNETES_NAMESPACE: Deployment namespace
  • HELM_RELEASE_NAME: Helm release identifier
  • SERVICE_DISCOVERY_ENABLED: Auto-discovery toggle
  • HEALTH_CHECK_INTERVAL: Health monitoring interval

Development Workflow​

Local Setup​

  1. Start DDEV: ddev start && ddev launch
  2. Check Services: Visit /admin/config/alternative_services
  3. Health Monitor: Visit /admin/reports/alternative_services/health
  4. Service Discovery: Enable auto-discovery in settings

Production Deployment​

  1. Deploy Helm Charts: Use charts from /Helm-Charts/
  2. Configure DNS: Point *.llm.bluefly.io to load balancer
  3. Enable SSL: Let's Encrypt certificates
  4. Monitor Services: Grafana dashboards

Service Discovery​

The platform automatically discovers services using:

  • Docker: Container inspection
  • Kubernetes: Service API
  • Health Checks: Regular endpoint monitoring
  • Port Scanning: Dynamic port detection

Security Considerations​

Local Development​

  • Services bound to localhost by default
  • DDEV provides automatic SSL certificates
  • Database access restricted to development environment
  • No external access unless explicitly configured

Production Deployment​

  • All services behind HTTPS with valid certificates
  • Network policies restrict inter-service communication
  • Secrets managed via HashiCorp Vault
  • Regular security scanning and updates

Troubleshooting​

Common Issues​

  • Port Conflicts: Check for conflicting services
  • Health Check Failures: Verify service endpoints
  • Discovery Issues: Enable detailed logging
  • SSL Certificate Problems: Check Let's Encrypt logs

Debug Commands​

# Check DDEV status
ddev describe

# Test service connectivity
curl -f http://localhost:11434/api/tags

# Check Drupal logs
ddev logs

# Alternative services debug
drush watchdog:show --filter=alternative_services

Updates and Maintenance​

This document is automatically updated by the platform's service discovery system. For manual updates, modify the service configurations in the alternative_services module and regenerate this documentation.

Last updated: Auto-generated from service discovery scan