> ## Documentation Index
> Fetch the complete documentation index at: https://docs.czautoz.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Whitelisting

> How CZ Autoz / Callatic vehicle server whitelisting works, and how to register your server IP.

CZ Autoz / Callatic vehicles verify that your server is licensed by checking your server's **public IP** against our whitelist. This is the same system the CZ Autoz helicopters use.

<Note>
  **Each mod is whitelisted on its own.** Every CZ Autoz mod — each pack, tier, single-vehicle car and the helicopter — has its **own** server-IP whitelist. Whitelist each mod you run with the #ip-whitelisting bot, or use **submit-all** to whitelist everything you own at once.
</Note>

## What happens if a server isn't whitelisted

On a non-whitelisted server the vehicles still **spawn and persist** — but the **engine will not start**, so they can't be driven. Whitelisting your server restores full functionality immediately (on the next check / restart).

## How to whitelist your server

<Steps>
  <Step title="Get your server's public IP">
    Use the **public IP** your server actually runs on (not your home connection). If you use a host or game-server panel, this is the server's listed IP.
  </Step>

  <Step title="Open the whitelisting channel">
    <Card title="IP Whitelisting Channel" icon="shield-check" href="https://discord.com/channels/768275677480353824/1168185657672356011">
      Open #ip-whitelisting in the CZ Autoz Discord
    </Card>
  </Step>

  <Step title="Register with the bot">
    Follow the CZ Autoz Bot's instructions in that channel to add your server IP. Once registered, you **don't need to restart** — a vehicle whose check previously failed **re-verifies automatically the next time someone starts its engine**, so just hop in and start a car. (A server restart also forces a fresh check.)
  </Step>
</Steps>

<Warning>
  If your server **IP changes** — switching hosts, a new box, or a dynamic IP — you must **re-whitelist the new IP**, or the engines will stop starting until you do.
</Warning>

## Checking your status — the whitelist log

Every CZ Autoz vehicle mod (and the helicopter mod) writes its whitelist status to a single shared log on your server:

```
$profile:\CZAutoz_Whitelist_YYYY-MM-DD.log
```

The file is **date-stamped**, so each day gets its own log. Each line is timestamped and tagged with the mod, for example:

```
18:00:01 | [BMW X6M] WHITELISTED (203.0.113.10:2302). Engine enabled.
18:00:01 | [Tier 4] NOT WHITELISTED. Engine disabled.
```

<Note>
  The log is shared on purpose — instead of one file per mod, you get a single place to confirm whether **all** your CZ Autoz content is whitelisted. It self-trims so it can't grow without bound.
</Note>

## Requirements for the check to work

The check runs **server-side** and needs outbound internet access so the server can confirm its IP against our whitelist. If your host blocks outbound HTTP from the game server, the check can't complete and the vehicles stay disabled (it retries automatically). Most hosts allow this by default.

<Note>
  **Built to be reliable.** The whitelist check runs **in the background (non-blocking)**, so it never holds up your server's startup. If a check can't reach our whitelist (a brief network blip or an ISP hiccup), it's treated as a temporary network issue and retried — it will **never** wrongly disable an already-registered server. It also stays on plain **HTTP** by design, so there's no certificate that could expire and lock your server out.
</Note>

<Card title="Already purchased, just need to whitelist?" icon="shield-check" href="https://discord.com/channels/768275677480353824/1168185657672356011">
  Go straight to the IP whitelisting channel
</Card>