Browse the docs

Scheduled scans and the digest

When SiteCMD scans your site on its own, how many scans you can ask for, and what the digest it emails you holds.

SiteCMD scans your site when you add it and again on a schedule, and emails you a digest of what it found. This page covers both. How a scan works explains what a scan checks.

The schedule

SiteCMD runs one scan of each site a day. Every scan runs every check, including the ones that open your pages in a browser. Each site keeps the same hour of the day for its scheduled scan, and the days are counted in UTC.

The first scan starts within a minute of adding the site, without waiting for you to prove the site is yours. It is that day's scan.

The schedule runs for as long as SiteCMD watches the site: with no end date while your proof that you own it stands, and without it, only for a limited time. Adding your site explains the proof.

On the Scans page

Scans lists every scan SiteCMD ran of the site. Each row says what started it, such as Daily for the scheduled scan. Open a scan to see each page it covered and the checks it could not speak for, with the reason.

If a scheduled scan does not finish, SiteCMD tries again on its schedule, and Scans lists the attempt.

Scans you ask for

Once you have proved you own the site, Run Scan in the top bar starts a scan, one at a time. Scans lists it as Requested. It runs beside the schedule and leaves the schedule as it was.

Each site can have up to three more scans a day besides its scheduled one: the ones you ask for, with Run Scan or Verify, and the ones a deploy starts. Past those three, SiteCMD turns down the scans you ask for, and a deploy's scan waits for the next UTC day.

The digest

The digest is your site's report by email: the first three things that need you, and how many in all, what SiteCMD did on its own, and what it is watching. When nothing needs you, it says so.

It comes weekly unless the site's settings say daily. A weekly digest goes out on Mondays at 14:00 UTC and covers the week before it. A daily digest goes out at 14:00 UTC each day and covers the day before it.

The digest goes to the address this site's alerts go to, which starts as the one you signed up with. Sites on your account that mail the same address, with the same digest and the same email contents, share one digest.

Choosing the digest

In the site's Settings, Notifications holds Alert Email. Its Digest setting chooses Weekly, Daily or No digest, and What the email may contain chooses how much each email names:

  • Private: the site's name, each item's severity and cause, and counts, but never a page's address or the evidence.
  • Minimal: only that something is waiting, with a link, and nothing about the site.

Alert Email Addresses, above it, lists the account's addresses, and each one can pause its digest.

What does not wait for the digest

By default, SiteCMD emails you at once when the site goes down and when it is back up, when a certificate or domain is close to expiring, when an ownership check misses your proof, and when a later scan finds a new critical or high finding. Alerts covers what SiteCMD emails, and when.