Authentication

Commands for managing user identity and verifying system connectivity.

register

Register a new user account with the authentication server.

vmr register [OPTIONS]

Options

Flag	Short	Description
--username <USERNAME>	-u	Username (prompts interactively if omitted)
--password <PASSWORD>	-p	Password (prompts securely if omitted)

Examples

vmr register -u myuser -p mypassword

vmr register
# Username: myuser
# Password: ********

TIP

When no flags are provided, the CLI prompts for credentials interactively. The password prompt uses secure input that does not echo characters to the terminal.

login

Log in to the registry and store credentials locally. The access token is persisted on disk so subsequent commands can authenticate automatically.

vmr login [OPTIONS]

Options

Flag	Short	Description
--username <USERNAME>	-u	Username (prompts interactively if omitted)
--password <PASSWORD>	-p	Password (prompts securely if omitted)

Examples

vmr login -u myuser -p mypassword

vmr login
# Username: myuser
# Password: ********

The login request is forwarded by the daemon to the auth server at the URL configured via VM_AUTH_SERVER_URL (or the active context's auth_server_url). On success, the returned JWT access token is saved in the local credential store.

logout

Log out from the registry and clear locally stored credentials. The daemon also notifies the auth server to revoke the associated refresh token.

vmr logout

Examples

vmr logout

ping

Check the health of the daemon, the registry server, and the authentication server. Reports latency for each reachable service.

vmr ping

Response Fields

Field	Description
status	Overall health status
auth_latency_ms	Round-trip time to the auth server in milliseconds
registry_latency_ms	Round-trip time to the registry server in milliseconds
timestamp	Server-side timestamp of the health check

Examples

vmr ping