Skip to content

Raw manifests install

Every Coxswain release publishes a pre-rendered install.yaml as a GitHub Release asset. It includes the Namespace, RBAC, GatewayClass, IngressClass, Services, PodDisruptionBudget, and Deployment, with the image pinned to the exact release tag.

Install the latest release

# Install Gateway API CRDs first (once per cluster)
kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/latest/download/standard-install.yaml

# Install Coxswain
kubectl apply -f https://github.com/coxswain-labs/coxswain/releases/latest/download/install.yaml

Note

The releases/latest/download/install.yaml URL resolves only after the first tagged release. It returns 404 if no v* tag has been published yet.

Pin a specific version

Replace vX.Y.Z with the release tag you want to install:

kubectl apply -f https://github.com/coxswain-labs/coxswain/releases/download/vX.Y.Z/install.yaml

Upgrade

kubectl apply -f https://github.com/coxswain-labs/coxswain/releases/download/vX.Y.Z/install.yaml

The Deployment rolling update strategy ensures zero-downtime upgrades when replicaCount ≥ 2.

Uninstall

kubectl delete -f https://github.com/coxswain-labs/coxswain/releases/download/vX.Y.Z/install.yaml

Warning

This removes the coxswain-system namespace and everything in it. Gateway API CRDs and any user-created Gateway/HTTPRoute/Ingress objects in other namespaces are not affected.