The ferndesk-assets router is missing or doesn't match your host. It serves the help center's scripts and styles from the root of your domain.
Put your help center on a sub-folder with Traefik
Serve your help center at a path on a site behind Traefik Proxy v3, such as yourcompany.com/help, with two routers and a service that points at Ferndesk.
Needs a payment method on file, which a trial with a card meets. Owners and admins can change this.
Set it up
Set the sub-folder in Ferndesk
In Help Center > Customize > Custom Domain, choose Custom sub-folder, enter your site's domain and a path such as /help, and click Configure subdirectory. Copy the Proxy host we show you (it looks like yourcompany.hc.ferndesk.com). The examples below use /help and www.yourcompany.com; replace them with your own.
Add the dynamic config
Add the config below to a file that Traefik's file provider loads, and replace PROXY_HOST with the proxy host and www.yourcompany.com with your site's host. Add your entry point and TLS settings to both routers, the same as your site's router. Traefik picks up file changes on its own when the provider watches the file.
# Dynamic configuration, loaded with the file provider
http:
routers:
ferndesk-help:
rule: "Host(`www.yourcompany.com`) && (Path(`/help`) || PathPrefix(`/help/`))"
middlewares: [ferndesk-strip, ferndesk-headers]
service: ferndesk
ferndesk-assets:
rule: "Host(`www.yourcompany.com`) && PathPrefix(`/_ferndesk/`)"
middlewares: [ferndesk-headers]
service: ferndesk
middlewares:
ferndesk-strip:
stripPrefix:
prefixes: ["/help"]
ferndesk-headers:
headers:
customRequestHeaders:
X-Ferndesk-Base-Path: "/help"
X-Ferndesk-Original-Host: "www.yourcompany.com"
services:
ferndesk:
loadBalancer:
passHostHeader: false
servers:
- url: "https://PROXY_HOST"passHostHeader: falsesends the proxy host as theHostheader. With the default, every page fails with a 403 error.Traefik ranks routers by the length of their rule, so these win over a router that matches only your host. If you set router priorities yourself, give these a higher one.
If your site's routers use Docker labels or Kubernetes, keep this service in the file provider and refer to it from another provider as
ferndesk@file.
We tested this config with Traefik 3.6 in Docker against a live Ferndesk help center, following Traefik's services documentation. If something doesn't work on your setup, email [email protected] with your config and the address that fails.
Check that it works
Open https://www.yourcompany.com/help. Your help center should load with its styling, and links between articles should stay on your domain. If something is off, see Troubleshoot your help center.
Common questions
The help center loads without styling
Every page shows a 403 error
Set passHostHeader: false on the Ferndesk service.
For a subdomain instead, or for other hosts, see Connect a custom domain to your help center.