mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-04-28 11:30:15 +00:00
69 lines
4.4 KiB
Markdown
69 lines
4.4 KiB
Markdown
# Pulse Documentation Index
|
||
|
||
Use this index to navigate the documentation bundled with the repository. Each
|
||
section groups related guides so you can jump straight to the material you need.
|
||
|
||
---
|
||
|
||
## Getting Started
|
||
|
||
- [INSTALL.md](INSTALL.md) – Installation guide covering script, Docker, and Helm paths.
|
||
- [FAQ.md](FAQ.md) – Common questions and troubleshooting quick answers.
|
||
- [MIGRATION.md](MIGRATION.md) – Export/import process for moving between hosts.
|
||
- [DEV-QUICK-START.md](../DEV-QUICK-START.md) – Hot reload workflow for local development.
|
||
- **Post-install checklist**
|
||
- [operations/audit-log-rotation.md](operations/audit-log-rotation.md) – Schedule regular sensor proxy log rotations after your first installation.
|
||
- [operations/sensor-proxy-log-forwarding.md](operations/sensor-proxy-log-forwarding.md) – Forward audit/proxy logs to your SIEM as soon as compliance retention is required.
|
||
- [operations/auto-update.md](operations/auto-update.md) – Enable and verify the `pulse-update` timer before handing the system to on-call.
|
||
- [operations/ADAPTIVE_POLLING_ROLLOUT.md](operations/ADAPTIVE_POLLING_ROLLOUT.md) – Plan the rollout when turning on adaptive polling beyond lab environments.
|
||
|
||
## Deployment Guides
|
||
|
||
- [DOCKER.md](DOCKER.md) – Container deployment walkthroughs and compose samples.
|
||
- [KUBERNETES.md](KUBERNETES.md) – Helm chart usage, ingress, persistence.
|
||
- [REVERSE_PROXY.md](REVERSE_PROXY.md) – nginx, Caddy, Apache, Traefik, HAProxy recipes.
|
||
- [DOCKER_MONITORING.md](DOCKER_MONITORING.md) – Docker/Podman agent installation.
|
||
- [HOST_AGENT.md](HOST_AGENT.md) – Host agent installers for Linux, macOS, Windows.
|
||
- [PORT_CONFIGURATION.md](PORT_CONFIGURATION.md) – Changing default ports and listeners.
|
||
|
||
## Operations & Monitoring
|
||
|
||
- [CONFIGURATION.md](CONFIGURATION.md) – Detailed breakdown of config files and env vars.
|
||
- [TEMPERATURE_MONITORING.md](TEMPERATURE_MONITORING.md) – Sensor proxy setup and hardening.
|
||
- [VM_DISK_MONITORING.md](VM_DISK_MONITORING.md) – Enabling guest-agent disk telemetry.
|
||
- [monitoring/](monitoring/) – Adaptive polling and Prometheus metric references.
|
||
- [WEBHOOKS.md](WEBHOOKS.md) – Notification providers and payload templates.
|
||
- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) – Deep dive into common operational issues.
|
||
- [../cmd/pulse-sensor-proxy/README.md](../cmd/pulse-sensor-proxy/README.md) – Host-side sensor proxy installation and operations guide.
|
||
|
||
## Security
|
||
|
||
- [SECURITY.md](../SECURITY.md) – Canonical security policy (root-level document).
|
||
- [docs/security/](security/) – Sensor proxy network and hardening guidance.
|
||
- [PROXY_AUTH.md](PROXY_AUTH.md) – Authenticating via Authentik, Authelia, etc.
|
||
- [TEMPERATURE_MONITORING_SECURITY.md](TEMPERATURE_MONITORING_SECURITY.md) – Legacy SSH considerations.
|
||
|
||
## Operations Runbooks
|
||
|
||
- [operations/audit-log-rotation.md](operations/audit-log-rotation.md) – Monthly/incident log rotation procedure that preserves the hash chain and validates scheduler health afterward.
|
||
- [operations/ADAPTIVE_POLLING_ROLLOUT.md](operations/ADAPTIVE_POLLING_ROLLOUT.md) – Rollout/rollback plan for enabling adaptive polling in staging or production.
|
||
- [operations/auto-update.md](operations/auto-update.md) – Lifecycle of the `pulse-update` timer/service: enablement, manual trigger, rollback, and observability.
|
||
- [operations/sensor-proxy-log-forwarding.md](operations/sensor-proxy-log-forwarding.md) – Configure rsyslog + RELP/TLS to ship sensor proxy audit/proxy logs to centralized logging.
|
||
|
||
## Reference
|
||
|
||
- [API.md](API.md) – REST API overview with examples.
|
||
- [api/SCHEDULER_HEALTH.md](api/SCHEDULER_HEALTH.md) – Adaptive scheduler API schema.
|
||
- [RELEASE_NOTES.md](RELEASE_NOTES.md) – Latest feature highlights and changes.
|
||
- [SCREENSHOTS.md](SCREENSHOTS.md) – UI tour with annotated screenshots.
|
||
- [DOCKER_HUB_README.md](DOCKER_HUB_README.md) – Summarised feature list for registries.
|
||
|
||
## Development & Contribution
|
||
|
||
- [CONTRIBUTING.md](../CONTRIBUTING.md) – Repository-wide contribution guide.
|
||
- [script-library-guide.md](script-library-guide.md) – Working with shared Bash modules.
|
||
- [development/MOCK_MODE.md](development/MOCK_MODE.md) – Using mock data while developing.
|
||
- [MIGRATION_SCAFFOLDING.md](../MIGRATION_SCAFFOLDING.md) – Tracking temporary migration code.
|
||
|
||
Have an idea for a new guide? Update this index when you add documentation so
|
||
discoverability stays high.
|