> ## 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 whitelist Crisp servers

*Learn what to whitelist when Crisp needs to run behind strict network, firewall, or CSP rules.*

Most companies do not need to whitelist Crisp manually. If your organization uses strict outbound filtering, bot protection, proxy rules, or a **Content Security Policy**, your IT team may need to allow Crisp domains, user agents, and sometimes server IP ranges.

---

# ${color}[#0080dd](What to whitelist)

Start with the resource that matches your restriction, then keep the Developer Hub as the source of truth for current values.

__The most common whitelisting needs are:__
* **CSP or domain filtering** → allow the Crisp domain names required by the chatbox, storage, images, and real-time messaging
* **Bot protection or server-side filtering** → allow Crisp server user agents so link previews, Webhooks, MagicBrowse, and probes can work
* **IP allowlists** → review Crisp server IP addresses only when your infrastructure requires fixed IP rules

Crisp infrastructure can evolve over time. Avoid hardcoding IP allowlists unless your security policy requires it, and prefer domain or user-agent allowlisting when possible.

---

# ${color}[#0080dd](Useful Developer Hub pages)

__Keep these references close when configuring firewall, proxy, or CSP rules:__
* [Whitelisting our Systems](https://docs.crisp.chat/guides/others/whitelisting-our-systems/) → overview of Crisp network requirements
* [Crisp Domain Names](https://docs.crisp.chat/guides/others/whitelisting-our-systems/crisp-domain-names/) → domains to allow for CSP and strict network policies
* [Server User Agents](https://docs.crisp.chat/guides/others/whitelisting-our-systems/server-user-agents/) → user agents used by Crisp services
* [Server IP Addresses](https://docs.crisp.chat/guides/others/whitelisting-our-systems/server-ip-addresses/) → IP ranges shared by Crisp when IP allowlisting is unavoidable

|| Some Crisp services may not support every hosting domain. If a page cannot be hosted on a restricted platform, host it on your own domain instead.