SSH, rsync & dependencies¶
Cannot connect¶
- Hostname/IP and port correct?
- Firewall allows SSH from PiHerder host?
- Test connection on SSH access panel.
- Key deployed? Password only for bootstrap.
Key deploy fails¶
- Password session required if key not yet installed.
authorized_keyspermissions on remote (~/.ssh700, file 600).- SELinux/AppArmor rare edge cases on some distros.
Backups: permission denied / rsync¶
- Non-root: need
sudo -n rsync(passwordless) for protected paths. - Root/HAOS: plain rsync path auto-detected.
- Path policy may deny the source — check allow/deny on Backups page.
Docker commands fail after least-priv¶
- User in
dockergroup? re-login / new session. - Docker base dir absolute path + Option B ACL if stacks under another home.
~/dockerexpands to wrong home after username switch.
Dependency chips red¶
SSH access → Check dependencies (or Test connection) — install missing packages on the host yourself (PiHerder does not auto-install).