Working days

Agent working days feature

Working-days scheduling limits the agent’s network activity to a configured daily window on selected weekdays. Outside that window, the agent pauses network activity and resumes automatically at the next permitted start time.

Quick usage

only-working-days: true
working-days:
  - monday
  - tuesday
  - wednesday
  - thursday
  - friday
working-day-start: '09:00'
working-day-end: '17:00'
working-day-timezone: Europe/Paris

Behavior

  • If the agent starts outside working hours, it waits until the next start time.
  • Both configured boundaries are active: an 09:00 to 17:00 window includes 09:00 and 17:00.
  • working-days defaults to Monday through Friday, preserving the behavior of older configurations.
  • Any combination of weekdays can be enabled, including weekends.
  • The next-start calculation skips disabled weekdays until it finds the next permitted day.
  • Duplicate weekday entries have no additional effect.

Options

  • --only-working-days: enable working-days scheduling.
  • --working-days: comma-separated permitted weekdays. Full and three-letter names are accepted case-insensitively, from monday/mon through sunday/sun.
  • --working-day-start: time at which the agent resumes network activity, in 24-hour HH:MM format.
  • --working-day-end: time at which the agent pauses network activity, in 24-hour HH:MM format.
  • --working-day-timezone: timezone used to interpret the start and end times, for example Europe/Paris.

The start time must be earlier than the end time. Equal endpoints and overnight ranges such as 17:00 to 09:00 are rejected.

Keeping the system awake

The agent can also prevent the host from sleeping or locking while it is running, which helps keep it reachable during the working period.

  • --keep-awake: prevent the system from sleeping or locking.

The mini-agent does not implement working-days scheduling.