diff --git a/charts/stable/cloudflared/docs/imgs/cloudflare-setup1.png b/charts/stable/cloudflared/docs/imgs/cloudflare-setup1.png new file mode 100644 index 00000000000..e5706b2494a Binary files /dev/null and b/charts/stable/cloudflared/docs/imgs/cloudflare-setup1.png differ diff --git a/charts/stable/cloudflared/docs/imgs/cloudflare-setup2.png b/charts/stable/cloudflared/docs/imgs/cloudflare-setup2.png new file mode 100644 index 00000000000..4f001d3ba3d Binary files /dev/null and b/charts/stable/cloudflared/docs/imgs/cloudflare-setup2.png differ diff --git a/charts/stable/cloudflared/docs/installation_notes.md b/charts/stable/cloudflared/docs/installation_notes.md index a749d0a2e00..71884bd2585 100644 --- a/charts/stable/cloudflared/docs/installation_notes.md +++ b/charts/stable/cloudflared/docs/installation_notes.md @@ -13,7 +13,7 @@ ![cf-tunnel-token.png](imgs/cf-tunnel-token.png) - Set the `token` with **your** tunnel's token. the tunnel ID will **NOT** work. -- Now you can manage the tunnel via cloudflare dash by setting a private network or create ingress rules for your services and domain. +- Now you can manage the tunnel via cloudflare dash by setting a private network or create ingress rules for your services and domain, explained in [Setting up individial apps](#setting-up-individual-apps) ![cf-tunnel-hostname](imgs/cf-tunnel-hostname.png) @@ -24,3 +24,32 @@ Notes: - You MAY need to modify cloudflared Zero Trust various settings in order for this work out-of-the-box which is beyond the scope of this guide. - You can use this as a reverse proxy directly or use it in conjunction with traefik if you are behind a CGNAT, do not have a static IP, or can not port forward 443 (SSL). + +## Setting up individual apps + +### Using traefik + +If you've set up your apps with traefik, you need to set up two public hostnames + +1. Set `domain` to your domain +2. Set `type` to `HTTPS` +3. Set `URL` to your traefik URL, usually `traefik-tcp.ix-traefik.svc.cluster.local:443` (make sure the port is the same as the port you specified in traefik config) +4. Under `Additional app settings` > `TLS`, set `Origin Server Name` to your domain. + +Setup should look like this: + +![cloudflare-setup](imgs/cloudflare-setup1.png) + +Then you need to do the same to set up the subdomain for each app you want to expose, using the same subdomain you specified in the app's ingress settings as follows: + +![cloudflare-setup](imgs/cloudflare-setup2.png) + +:::danger Wildcard Subdomains + +It's also possible to set up access to all apps at once by using a wildcard `*` subdomain public hostname, and then adding a CNAME record in the DNS settings with name=`*` and target equal to the target in the CNAME record for the parent domain, but this is not recommended due to security concerns. + +::: + +### Without traefik + +If you've not set up traefik and ingress, and exposing the ports using the normal loadbalancer, you only need to set up each app individually, and set `URL` to `:` for each app.