The /_ferndesk/* block is missing. It serves the help center's scripts and styles from the root of your domain.
Put your help center on a sub-folder with Caddy
Serve your help center at a path on a site that runs on Caddy 2, such as yourcompany.com/help, with two handle blocks in your Caddyfile.
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 blocks and reload
Add the two handle blocks below to your site's block, replace PROXY_HOST with the proxy host, and reload Caddy with caddy reload. If the rest of your site sits in its own handle block, keep it after these.
www.yourcompany.com {
@ferndesk_help path /help /help/*
handle @ferndesk_help {
uri strip_prefix /help
reverse_proxy https://PROXY_HOST {
header_up Host {upstream_hostport}
header_up X-Ferndesk-Base-Path /help
header_up X-Ferndesk-Original-Host {host}
}
}
handle /_ferndesk/* {
reverse_proxy https://PROXY_HOST {
header_up Host {upstream_hostport}
header_up X-Ferndesk-Base-Path /help
header_up X-Ferndesk-Original-Host {host}
}
}
# ...your existing site config
}header_up Host {upstream_hostport}sends the proxy host as theHostheader, which Ferndesk needs to accept the request.The
path /help /help/*matcher keeps other paths that start with the same letters, such as/helpful, on your site.
We tested this config with Caddy 2.11 in Docker against a live Ferndesk help center, following Caddy's reverse_proxy 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
For a subdomain instead, or for other hosts, see Connect a custom domain to your help center.