How to route the Knowledge Base behind a reverse proxy

Serve your Crisp Knowledge Base through a reverse proxy when you need advanced hosting control.

Most teams should use a regular custom Knowledge Base domain. A reverse proxy is an advanced setup for cases where you need to serve the Knowledge Base from a custom server, a custom route, or a specific subfolder such as mywebsite.com/help.

Before using a reverse proxy

A reverse proxy can be useful when you need to host the Knowledge Base under a custom domain, custom server, custom IP, or subfolder.

If you only need a custom subdomain such as help.acme.com, start with Setup your Knowledge Base domain name instead. It is simpler to maintain than a reverse proxy.

Host the Knowledge Base on a subdomain

The example below uses Nginx to proxy a Crisp Knowledge Base from the root of a custom host. Replace MY_CRISP_KNOWLEDGE_BASE with your own Crisp Knowledge Base subdomain.

location / {
    proxy_pass https://MY_CRISP_KNOWLEDGE_BASE.crisp.help;

    proxy_http_version 1.1;

    proxy_intercept_errors on;
    proxy_ssl_server_name on;
}

Host the Knowledge Base on a subfolder

Use this example if you want the Knowledge Base to be available from a subfolder such as mywebsite.com/help. Replace MY_SUBFOLDER and MY_CRISP_KNOWLEDGE_BASE with your own values.

location /MY_SUBFOLDER/ {
    proxy_pass https://MY_CRISP_KNOWLEDGE_BASE.crisp.help/en/;
    proxy_http_version 1.1;

    proxy_ssl_server_name on;

    proxy_set_header Accept-Encoding "";
    proxy_set_header Access-Control-Allow-Origin "*";
    sub_filter 'action="https://MY_CRISP_KNOWLEDGE_BASE.crisp.help/en/' 'action="/MY_SUBFOLDER/';
    sub_filter 'href="/en/' 'href="/MY_SUBFOLDER/';
    sub_filter 'action="/en/' 'action="/MY_SUBFOLDER/';

    sub_filter_once off;
}

Reverse proxy setups depend on your own server, DNS, SSL, cache, and security configuration. If the proxy behaves unexpectedly, check your web server logs first.

Frequently Asked Questions

Still have questions which were not covered in this article? Here is a collection of the most frequently asked questions on this topic.

Should I use a reverse proxy or a custom domain?

Use a custom domain unless you specifically need reverse proxy behavior. A custom domain is easier to configure and maintain, while a reverse proxy gives more control but requires server administration.

Can I adapt the Nginx examples for Apache or HAProxy?

Yes, the same idea can be adapted to other reverse proxy servers. The exact directives differ, so translate the proxy pass, SSL server name, and rewrite behavior to the server you use.

Updated on: 03/05/2026

Was this article helpful?

Thank you!