Tailscale and WireGuard
If your team uses Tailscale or WireGuard, you can give all Chainalysis traffic one fixed exit point: a server you control with a static public IP. Users can work from anywhere, and Chainalysis only ever sees your registered address.
Choose an option
Note: Tailscale’s Mullvad exit nodes and other commercial VPN services are shared with other customers, so we can’t allowlist them. The exit point must be a server you control with a static IP.
Before you begin
To follow this guide, you’ll need:
- A Linux server with a static public IP. For example, a cloud VM with an AWS Elastic IP, an Azure static public IP, or a reserved Google Cloud address. Run two servers in different zones if you need resilience, and register both IPs.
- For Tailscale: Owner, Admin or Network admin rights on your tailnet, and access to edit the tailnet policy file.
- For WireGuard: root access on the server and a way to distribute client configurations.
- Your Chainalysis CSM contact in order to register your IPs.
Prepare the server
All three options need IP forwarding turned on. On the server, run:
Then check the server’s public IP with curl -s https://kyt.chainalysis.com/cdn-cgi/trace. This is the address you’ll register with Chainalysis. If the server also has IPv6, note its /64 range.
Option A: Tailscale app connector
An app connector routes traffic for specific domains through a chosen device. Clients keep their normal internet path for everything else. App connectors are available on all Tailscale plans and run on Linux.
Update the tailnet policy file
In the Tailscale admin console, open Access controls and add these sections (merge them into any you already have):
Your grants must also let users reach internet routes (autogroup:internet) and the connector on port 53 for DNS:
Check the app in the console
Open the Apps page in the admin console. You should see the Chainalysis app with your connector listed. If you manage your policy file with GitOps or Terraform, make the changes there instead, or they will be overwritten.
Note: Traffic to Chainalysis domains leaves from the connector’s public IP, not its Tailscale (100.x) address, even if the user also has an exit node turned on. Register the public IP.
Option B: Tailscale exit node
Approve it
In the admin console, open Machines, find the server (it shows an Exit Node badge), open its menu and select Edit route settings > Use as exit node. You can also auto-approve exit nodes with autoApprovers in the policy file.
Option C: Self-hosted WireGuard
WireGuard routes by IP address, not domain name. Because Chainalysis IP addresses change, Chainalysis users need a full tunnel: all traffic goes through the server while the tunnel is up.
Register your IPs with Chainalysis
For all options, you must register your IPs with Chainalysis. Send your CSM or Chainalysis support the public IP of every connector, exit node, or WireGuard server, plus the IPv6 /64 of each if it has IPv6. Don’t send Tailscale (100.x) or WireGuard tunnel (10.x) addresses: these are private and can’t be allowlisted.
Your allowlist can contain up to 50 IP addresses. If your number of IPs exceeds 50, you can request an exception through your CSM or Chainalysis Support.
The following table details the types of IPs we support.
At this time, we do not accept private addresses (10.x, 172.16-31.x, 192.168.x, 100.64.x), home internet connections, shared or commercial VPN services, shared security-cloud egress pools, or broad ISP ranges.
Your CSM will tell you when the allowlist is live.
Confirm your connection
- With Tailscale or WireGuard connected, sign in to KYT.
- For an exit node or WireGuard, run
curl -s https://kyt.chainalysis.com/cdn-cgi/traceon the client: it should return the server’s static IP.- With an app connector, this shows the connector’s public IP, because traffic to Chainalysis domains goes through the connector.
- For an app connector, run
tailscale statuson the client and check if the connector is online, then confirm KYT sign-in works from a network that isn’t registered. - Run a test API call from every system that uses the Chainalysis API.
When you confirm your connection, we recommend resetting your password (if your organization uses SSO, you can skip this). To reset your password, log out and go to app.chainalysis.com. Enter your email address, click Continue, select Reset password, and follow the on-screen instructions.
We also recommend rotating your API key by following the steps on this page.
If you have issues, please contact support@chainalysis.com.
Common issues
Users forget to turn on the exit node.
- Likely cause: The exit node is optional on the client.
- How to resolve: Use an app connector instead, or deploy a mandatory exit node with MDM.
WireGuard connects but nothing loads.
- Likely cause: IP forwarding or NAT isn’t set on the server.
- How to resolve: Recheck the forwarding settings and the
MASQUERADErule.
Blocked even though your IPv4 address is registered.
- Likely cause: Your network is dual-stack and the browser or client is connecting over IPv6.
- How to resolve: Send your IPv6
/64range to your CSM or Chainalysis Support. As a quick test, disable IPv6 on the device and retry.
Sign-in works but API calls return a 403 error.
- Likely cause: The API key doesn’t have the right permissions or the API key must be rotated, even though the IP is allowed.
- How to resolve: Check the API key’s permissions in your Chainalysis account, or create a new key.
- API keys created before November 2, 2026 no longer work. To replace one, follow the key rotation steps.
Additional support
We’re here to help. For questions, contact your Chainalysis CSM or Chainalysis Support.