Warda-DNSDocs

Scheduled tasks

Administration → Scheduled tasks (GET /api/v1/tasks) lists what Warda runs by itself, with the last run (time, duration, error), the next one and whether it is running:

Task When
Blocklists (lists), and one per sensitive category in use (lists.category.<id>) at start, then every 24 hours (list_refresh, with up to 10% jitter)
Watch of the cuts (watch.cuts) every 2 minutes
Profiles by age (profiles.ages) at start, then every hour
School holidays (holidays) checked daily; the official calendar imported again when older than 7 days
Sorting of the new devices (devices.classify) 1 minute after start, then every 10 minutes
Local names (dns.local_names) every minute
Presence on the network (network.presence) every 15 minutes
Network scan (network.scan) 2 minutes after start, then every night at 03:15
Local learning (learning) shortly after start, then every hour
Certificate of the encrypted DNS (certificate) 10 minutes after start, then every 12 hours: renewed 30 days before its end
DNSSEC check (dnssec.check) a minute after start, then every 6 hours
Country database (geoip) 5 minutes after start, then every day
Retention of the journal (journal.retention) 1 minute after start, then every hour
Nightly backup (backup) every night at 01:30 (once a backup password is set)
Updates (updates, Debian package) run by the system (warda-update.timer), between 02:00 and 05:00

A run that had nothing to do (no backup password, a scan already running) is not counted. The times are those of the box; the state is kept in memory and starts again with Warda.

The countries come from IP to Country Lite by DB-IP (CC BY 4.0, see NOTICE): the release build ships the database of the month (internal/geoip, stage geoip of the Dockerfile) and Warda downloads the new one each month (download.db-ip.com) into its data directory. Only the country of the first address of each answer is counted, per day for the whole network (kept 35 days); the queries keep no address.

Each installation draws a random identifier, WRD-FR-1234-ABCD-EFGH: the country of its time zone (TZ, /etc/timezone or /etc/localtime; ZZ when unknown, corrected in Administration → Settings), four digits and eight characters. It is shown on the dashboard and kept in backups; nothing of the machine is in it, and it is never sent by Warda. (A check that no other installation has the same one will come with the online services.)