docs: add cron/systemd integration guide #103

Merged

fuzzy merged 2 commits from feature/0047-integrate-with-cron into main

2026-07-05 14:40:26 +00:00

automation commented

2026-07-05 14:37:49 +00:00

Owner

What

Add documentation for integrating kronai with cron and systemd, including example crontab entries and systemd service/timer unit files.

Why

Users need guidance on how to schedule kronai job intervals via the system's standard scheduling mechanisms.

Testing

Documentation only — no code changes.

Closes #0045
Closes #0046
Closes #0047

## What Add documentation for integrating kronai with cron and systemd, including example crontab entries and systemd service/timer unit files. ## Why Users need guidance on how to schedule kronai job intervals via the system's standard scheduling mechanisms. ## Testing Documentation only — no code changes. Closes #0045 Closes #0046 Closes #0047

automation added 2 commits

2026-07-05 14:37:49 +00:00

docs: add cron/systemd integration guide c7b5a8cb0f

- Crontab examples for hourly/daily/weekly/monthly
- systemd service and timer unit files
- Logging and configuration guidance
Closes #0045
Closes #0046

docs: mark Phase 3 Task 3 complete

CI / test (pull_request) Successful in 54s

Details

CI / lint (pull_request) Successful in 1m19s

Details

276802673d

Cron/systemd integration docs with examples done.
Closes #0047

the.auditor approved these changes

2026-07-05 14:39:56 +00:00

the.auditor left a comment

Automated Review — PR #103

Result: APPROVED

Clean documentation. Covers both cron and systemd setups with clear examples. No code changes.

Completeness: Closes #45–#47. ROADMAP updated.
Clarity: Well-structured, examples for all four intervals, covering PATH, config paths, logging, and both service + timer units.
Correctness: systemd Type=oneshot, template units with %i, Persistent=true, and journalctl usage are all correct.

Suggestions (non-blocking)

docs/cron-integration.md:99-100 — The service unit sets Environment=KRONAI_CONFIG=/etc/kronai/config.toml but the CLI doesn't read a KRONAI_CONFIG env var — it uses --config flag. The env var will have no effect. Use ExecStart=/usr/local/bin/kronai --config /etc/kronai/config.toml %i instead, or add KRONAI_CONFIG env var support to cli.py / config.py.

## Automated Review — PR #103 **Result: APPROVED** --- Clean documentation. Covers both cron and systemd setups with clear examples. No code changes. - **Completeness**: Closes #45–#47. ROADMAP updated. - **Clarity**: Well-structured, examples for all four intervals, covering PATH, config paths, logging, and both service + timer units. - **Correctness**: systemd `Type=oneshot`, template units with `%i`, `Persistent=true`, and `journalctl` usage are all correct. ### Suggestions (non-blocking) 1. **`docs/cron-integration.md:99-100`** — The service unit sets `Environment=KRONAI_CONFIG=/etc/kronai/config.toml` but the CLI doesn't read a `KRONAI_CONFIG` env var — it uses `--config` flag. The env var will have no effect. Use `ExecStart=/usr/local/bin/kronai --config /etc/kronai/config.toml %i` instead, or add `KRONAI_CONFIG` env var support to `cli.py` / `config.py`.

the.auditor referenced this pull request

2026-07-05 14:40:00 +00:00

docs: KRONAI_CONFIG env var in systemd example doesn't work #104

fuzzy merged commit 276802673d into main

2026-07-05 14:40:26 +00:00

fuzzy deleted branch feature/0047-integrate-with-cron

2026-07-05 14:40:26 +00:00