This article shows how to use Crisp Helpdesk 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 Helpdesk. A reverse proxy can be used in multiple use cases:

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

Solution 1: Host the helpdesk 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_HELPDESK.crisp.help;

    proxy_http_version 1.1;

    proxy_intercept_errors on;
    proxy_ssl_server_name on;
}

Solution 2: Host the helpdesk on a subfolder

location /MY_SUBFOLDER/ {
    proxy_pass https://MY_CRISP_HELPDESK.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_HELPDESK.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: 11/03/2024