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-namespaceWait 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-nginxVerify service and ip allocation
kubectl get svc -n ingress-nginxInformation 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 sectionTroubleshooting
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.