Common Error Messages

Reference guide for daemon error messages and their solutions.

Common Error Messages

401 Unauthorized

The daemon credentials are invalid or expired. Rotate credentials from the host detail page in the dashboard.

403 Forbidden

The host is not authorized to access the requested resource. This usually means the host was removed from the team.

connection refused

The daemon cannot reach the control plane. Check firewall rules and DNS resolution.

certificate verify failed

The system CA certificates are outdated. Update them:

# Debian/Ubuntu
sudo apt update && sudo apt install ca-certificates

# RHEL/CentOS
sudo yum update ca-certificates

permission denied: authorized_keys

The daemon does not have write access to the authorized_keys file. Ensure the daemon runs as root or has appropriate permissions.

drift detected

This is informational, not an error. It means someone manually edited the authorized_keys file. Lockwave will correct it on the next sync.