# Gluetun Integration

[Gluetun](https://github.com/qdm12/gluetun) is famously strict. It does not possess banlists or rotation logic for blocked IPs. If you assign Gluetun to AirVPN, it connects blindly.

**AirBL solves this by bypassing Gluetun's built-in AirVPN logic and natively feeding it a custom `servers.json`.**

## Creating a Profile

Inside the Settings UI > **Gluetun Integration**:
1. Click **Add Profile**.
2. **Output Path**: Set where to deposit the JSON file (e.g., a volume shared with your Gluetun container).
3. **Endpoint Route Strategy**: 
   - `ALL`: Exports both Entry 1 and Entry 3.
   - `ENTRY1`/`ENTRY3`: Forces strict routes.
   - `PING_PRIORITY`: The system automatically drops the worst-performing entry endpoint and feeds Gluetun safely with the lowest-latency IP currently available.
4. Set allowed countries/cities and bandwidth limits.

## Smart Restarts

If you expose Gluetun's control API to AirBL (port 8000), AirBL can seamlessly restart the VPN connection to enact changes.

**Force Update Mode:**
- **Clean Only:** The safest option. AirBL matches the active IP running in Gluetun to its internal index. If the active IP is struck by a DroneBL block, Gluetun is forcibly restarted. Otherwise, it is left alive.
- **Reset if not Top 4:** Forces a restart if your active VPN session is no longer operating on the top 4 servers by score.
- **Always Restart:** Destructive cyclic restart every interval.