Commands
Two surfaces: the local command you run on your own machine to sync your crons and pull logs, and the service commands you run on the server to manage the API and the runner. The local command is the one you use daily; the server commands are for setup and the occasional check-in.
cronhoster-local.js
The one command in the local package. It reads your
config.json, then runs each step you ask for, in order: the
sync first, then each log browser. A run does its work once and exits.
node cronhoster-local.js --config /path/to/config.json --all
| Flag | Meaning |
|---|---|
--config <path> | Required. The full absolute path to your config, a
.json file. |
--sync | Upload every cron directory the server does not have yet, and remove any you have deleted locally. See Sync. |
--web-logs | Mirror the access log and build the Web Logs browser. |
--server-logs | Mirror the health samples and build the Server Logs browser. |
--cron-logs | Mirror the run records and build the Cron Logs browser. |
--all | All four steps above. |
The pages land under your cronhoster-config-tools
folder; the Tools section shows what each one looks like. To sync on a timer, run
the command from your own scheduler.
Server-side services
The installer lays down two systemd units. Manage them with ordinary
systemctl; they run as a dedicated non-root user.
# is the sync API healthy?
systemctl status cronhoster-api
# is the scheduler running your crons?
systemctl status cronhoster-runner
# restart the scheduler
sudo systemctl restart cronhoster-runner
| Command | Purpose |
|---|---|
systemctl status cronhoster-api | Health of the localhost sync API that the local package uploads to. |
systemctl status cronhoster-runner | Health of the scheduler that discovers crons and runs their handlers on time. |
systemctl restart cronhoster-api | Restart the sync API, for example after the token changes. |
systemctl restart cronhoster-runner | Restart the scheduler. In-flight runs stop, and times that pass while it is down are skipped. |
journalctl -u cronhoster-runner | The service's own journal: its starts and stops, and one line per cron added, removed or broken. Per-run detail lives in the run records. |
Each run is captured as a structured record (duration, exit code, and the tail of its
stdout/stderr), written to dated day-files server-side, pruned after fourteen
days, and shown per run in the Cron Logs tool.