This article shows how to use Crisp Knowledge Base behind a custom page like help.mywebsite.com or on a specific subfolder like mywebsite.com/help.

Reverse proxy usecase

This article covers how to use a reverse proxy for your Crisp Knowledge Base. A reverse proxy can be used in multiple use cases:

Using Crisp Knowledge Base under a custom domain
Using Crisp Knowledge Base on a custom IP or custom server
Using Crisp Knowledge Base in countries where Crisp is unavailable because blocked by Governments (ie. Russia, China)

Solution 1: Host the Knowledge Base on a subdomain

The solution is to use a reverse proxy. The following example shows how to use a Nginx Reverse proxy. The same solution could be achieved by using Apache, or HAProxy.

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

    proxy_http_version 1.1;

    proxy_intercept_errors on;
    proxy_ssl_server_name on;
}

Solution 2: Host the Knowledge Base on a subfolder

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;
}

Updated on: 17/02/2025