Launching the PlatformSelf-hosted: On-premPrerequisites

Ingress Controller

Setup and configure the ingress controller for your self-hosted platform

Overview

Purpose

  • Managing external access to services
  • Load balancing
  • SSL/TLS termination
  • Routing rules

Requirements

  • Kubernetes cluster access
  • Load balancer support
  • Helm (optional)

Deployment options

Install with Helm

helm upgrade --install ingress-nginx ingress-nginx \
  --repo https://kubernetes.github.io/ingress-nginx \
  --namespace ingress-nginx \
  --create-namespace

Wait for the load balancer IP to be assigned:

kubectl get service -n ingress-nginx ingress-nginx-controller \
  --output jsonpath='{.status.loadBalancer.ingress[0].ip}'

Cloud Provider Marketplaces

Choose your cloud provider's marketplace offering:

Digital Ocean

  • Install "NGINX Ingress Controller" from marketplace
  • Automatically configures load balancer

CIVO

  • Enable "Nginx ingress controller" during cluster creation
  • Or add from marketplace post-creation

Other Providers

  • Most cloud providers offer similar marketplace solutions
  • Follow provider-specific installation steps

Validation

Check pods are running

kubectl get pods -n ingress-nginx

Verify service and ip allocation

kubectl get svc -n ingress-nginx

Information collection

Required values for platform installation

  • Ingress class name (default: nginx)
  • Load balancer IP address
  • Ingress controller namespace
ingress:
  enabled: true
  className: nginx
  # Other ingress settings will be configured in Domain & TLS section

Troubleshooting

No Load Balancer IP

  • Verify cloud provider load balancer service is running
  • Check cloud provider quotas
  • Ensure correct service annotations

Controller Not Ready

  • Check pod logs: kubectl logs -n ingress-nginx <pod-name>
  • Verify resource requirements are met
  • Check network policies

Next steps

Verify ingress controller is running

Ensure the controller pods are healthy and ready before proceeding.

Note down the load balancer IP

Record the external IP assigned to the ingress controller service for later DNS configuration.

Proceed to Domain and TLS Setup

Continue the installation by configuring your domain and TLS settings.

Need help? Contact [email protected] if you encounter any issues.