Doctor

jalth doctor inspects your local environment and mesh connectivity. Use --fix to apply supported self-healing actions.

jalth doctor
jalth doctor --fix

What it checks

Category	Checks
Prerequisites	warp-cli, WARP daemon, cloudflared, ssh/sshd, sudo
WARP state	Enrollment status, org match, connectivity
Mesh config	~/.jalth/config.json validity, registry reachability
Split tunnel	Include-mode routes for CGNAT and egress ranges
DNS	Gateway DNS override resolution for .mesh names
SSH	CA configuration, sshd status
Version drift	CLI vs Worker version compatibility

Self-healing fixes (--fix)

Fix	What it does
Restart WARP	Restarts the WARP daemon service
Flush DNS	Clears local DNS cache
Connect WARP	Reconnects to the mesh
Install cloudflared	Downloads and installs cloudflared
Ensure DNS resolver	Configures cloudflared DNS resolver
chmod config	Fixes config file permissions
Linux resolv.conf	Makes resolv.conf writable for DNS fixes

Tip

Run jalth doctor before filing a bug report. Include its output in your report with jalth bugreport.

Common issues

WARP enrolled in wrong org — Leave the existing org first, then re-join.

Missing MDM profile — jalth doctor --fix may guide WARP setup; requires sudo.

Worker version drift — Warning emitted when CLI and Worker versions differ. Admin should run jalth upgrade --worker-only.

DNS not resolving .mesh names — Check Gateway DNS overrides and split tunnel configuration.