mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-04-28 03:20:11 +00:00
docs: standardize markdown syntax and remove deprecated sensor-proxy docs
This commit is contained in:
parent
39d647c947
commit
ee63d438cc
45 changed files with 228 additions and 512 deletions
|
|
@ -34,56 +34,56 @@ sudo pulse bootstrap-token
|
|||
|
||||
### Authentication
|
||||
|
||||
**"Invalid username or password" after setup**
|
||||
#### "Invalid username or password" after setup
|
||||
- **Docker Compose**: Did you escape the `$` signs in your hash? Use `$$2a$$...`.
|
||||
- **Truncated Hash**: Ensure your bcrypt hash is exactly 60 characters.
|
||||
|
||||
**Cannot login / 401 Unauthorized**
|
||||
#### Cannot login / 401 Unauthorized
|
||||
- Clear browser cookies.
|
||||
- Check if your IP is locked out (wait 15 mins).
|
||||
- If another admin can log in, use `POST /api/security/reset-lockout` to clear the lockout for your username or IP.
|
||||
|
||||
**Audit Log verification shows unsigned events**
|
||||
#### Audit Log verification shows unsigned events
|
||||
- **Symptom**: Audit Log entries show “Unsigned” or verification fails in the UI.
|
||||
- **Root cause**: `PULSE_AUDIT_SIGNING_KEY` is not set, so events are stored without signatures.
|
||||
- **Fix**: Set `PULSE_AUDIT_SIGNING_KEY` and restart Pulse Pro. Newly created events will be signed; existing unsigned events remain unsigned.
|
||||
|
||||
**Audit Log is empty**
|
||||
#### Audit Log is empty
|
||||
- **Symptom**: Audit Log shows zero events or "Console Logging Only."
|
||||
- **Root cause**: OSS build uses console logging only, or Pulse Pro audit logging is not enabled.
|
||||
- **Fix**: Use Pulse Pro with audit logging enabled, then generate new audit events (logins, token creation, password changes).
|
||||
|
||||
**Audit Log verification fails for older events**
|
||||
#### Audit Log verification fails for older events
|
||||
- **Symptom**: Older events fail verification while newer events pass.
|
||||
- **Root cause**: The signing key changed or was rotated, so signatures no longer match.
|
||||
- **Fix**: Keep `PULSE_AUDIT_SIGNING_KEY` stable. If rotated intentionally, expect older events to fail verification.
|
||||
|
||||
### Monitoring Data
|
||||
|
||||
**VMs show "-" for disk usage**
|
||||
#### VMs show "-" for disk usage
|
||||
- Install **QEMU Guest Agent** in the VM.
|
||||
- Enable "QEMU Guest Agent" in Proxmox VM Options.
|
||||
- Restart the VM.
|
||||
- See [VM Disk Monitoring](VM_DISK_MONITORING.md).
|
||||
|
||||
**Temperature data missing**
|
||||
#### Temperature data missing
|
||||
- Install `lm-sensors` on the host.
|
||||
- Run `sensors-detect`.
|
||||
- Install the unified agent on the Proxmox host with `--enable-proxmox`.
|
||||
- See [Temperature Monitoring](TEMPERATURE_MONITORING.md).
|
||||
|
||||
**Docker hosts appearing/disappearing**
|
||||
#### Docker hosts appearing/disappearing
|
||||
- **Duplicate IDs**: Cloned VMs often share `/etc/machine-id`.
|
||||
- **Fix**: Run `rm /etc/machine-id && systemd-machine-id-setup` on the clone.
|
||||
|
||||
### Notifications
|
||||
|
||||
**Emails not sending**
|
||||
#### Emails not sending
|
||||
- Check SMTP settings in **Alerts → Notification Destinations**.
|
||||
- Check logs: `docker logs pulse | grep email`.
|
||||
- Ensure your SMTP provider allows the connection (e.g., Gmail App Passwords).
|
||||
|
||||
**Webhooks failing**
|
||||
#### Webhooks failing
|
||||
- Verify the URL is reachable from the Pulse server.
|
||||
- If targeting private IPs, allow them in **Settings → System → Network → Webhook Security**.
|
||||
- Check Pulse logs for HTTP status codes and response bodies.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue