Home / Docs / etcd (Hardened) / Troubleshooting
| Symptom | Check | Fix |
|---|---|---|
| Remote clients can't connect | --listen-client-urls flag | Loopback by design; see deploy step 2 for the safe path. |
| database space exceeded | etcdctl endpoint status (DB size vs quota) | Compact + defrag: etcdctl compact <rev> && etcdctl defrag. |
| Member won't start after volume restore | Data dir contains old member identity | Restore via etcdctl snapshot restore (rewrites member identity), not raw file copy. |
etcdctl endpoint health → 127.0.0.1:2379 is healthy