Skip to content

Adding A Provider

github-actions[bot] edited this page Jul 4, 2026 · 1 revision

Adding A Provider

Providers implement the shared interface in internal/provider. The controller expects a provider to clone or create an instance, start it, execute guest commands, return an address when available, stop/delete it, and list existing instances for prefix-safe cleanup. Tart, WSL, and Docker-DinD are the current examples of that boundary.

Keep provider behavior idempotent where possible. Cleanup must only remove instances whose names match pool.namePrefix.

Use provider-specific docs for host setup, image format, and isolation caveats. New providers should also document whether runner liveness uses systemd or the PID-file fallback in /opt/epar/check-runner.sh.

Clone this wiki locally