Skip to main content

​
Overview

Velatir checks its own health every ~30 seconds. If something breaks it never blocks your traffic: it either pauses capture or steps aside so connections flow directly, then recovers on its own once the problem clears. Read the current state with velatir health.

​
States

​
Reading velatir health

Each failing check shows a reason and the action Velatir took. The exit code is 0 when healthy and non-zero when degraded, so the command works as a monitoring probe. Add --json for the raw snapshot.

​
If it shows a problem

A degraded state usually clears on its own. If it persists:
  • Certificate not trusted: see Troubleshooting → Certificates.
  • macOS extension not enabled: approve it in System Settings → General → Login Items & Extensions → Network Extensions.
  • Anything else: run velatir logs --host -f, reproduce, and share the output with support.

​
Next Steps

Troubleshooting

Resolve a degraded state.

CLI reference

The health and test commands in detail.