Quickstart

Install on Linux

The installer supports Linux on x86-64 and arm64. It downloads a self-contained server runtime and, when systemd is available, starts it as a service.

curl -fsSL https://www.codevisor.dev/install.sh | sh

The default port is 49361. A non-root install lives under ~/.codevisor/server and creates a user service; a root install uses /opt/codevisor and a system service.

Check health locally

curl http://127.0.0.1:49361/v1/health

The health endpoint is the only endpoint that never requires a bearer token.

Issue a pairing token

Run this command on the server machine. Localhost requests are trusted when token authentication is enabled.

TOKEN=$(curl -fsS -X POST http://127.0.0.1:49361/v1/auth/pairing-token \
  | jq -r .token)

Treat the returned hm_… token as a password. Remote requests send it as a bearer token:

curl http://SERVER_ADDRESS:49361/v1/info \
  -H "Authorization: Bearer $TOKEN"

You can also enter the machine address and token in Codevisor under Machines → Add Machine.