> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.crisp.chat/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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`.

---

# ${color}[#0080dd](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](/en/article/setup-your-knowledge-base-domain-name-1fkjw73/) instead. It is simpler to maintain than a reverse proxy.

---

# ${color}[#0080dd](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.

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

    proxy_http_version 1.1;

    proxy_intercept_errors on;
    proxy_ssl_server_name on;
}
```

---

# ${color}[#0080dd](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.

```nginx
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.

---

# ${color}[#0080dd](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.*

###### ${color}[#F08820](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.

###### ${color}[#F08820](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.