Skip to content

Installation Notes

Cloudflared Tunnel Creation

  • Go to cloudflare team dash and create a tunnel or migrate a current tunnel (this action is not reversible) by going to access and then tunnels tab.

cf-tunnel-access-tunnel.png

  • Create a tunnel like so (or migrate a current one)

cf-tunnel-tunnel-create.png

  • Copy JUST the token from tunnel’s overview Install and run a connector section.

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, explained in Setting up individial apps

cf-tunnel-hostname

  • 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

  • Set subdomain to a sub domain (can be left blank to use the root domain)
  • Set domain to your domain
  • Set type to HTTPS
  • 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)
  • Under Additional app settings > TLS, set Origin Server Name to your domain (This needs to match what you have set for the sub and root domain; ex someapp.somedomain.com).

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

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 <TrueNAS Local IP>:<PORT of app> or cluster app url for each app.