> For the complete documentation index, see [llms.txt](https://docs.earthindex.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.earthindex.ai/monthly-search-beta/notifications-and-limits.md).

# Auto-runs and limits

Turn on Monthly Search (monitoring) auto runs, choose who gets email, and know the limits that apply and what to check when a limit stops a run.

{% hint style="warning" %}
Monthly Search is in beta.
{% endhint %}

In a Monthly Search (monitoring) project, **Auto Run New Months** runs your detector on each new month and can email you when results are ready. If a limit stops a run, no email tells you: check the app.

## Before you start

* Your project has a trained detector and at least one month with results. Until then the card reads "Run at least one month before turning on auto runs." See [Run and compare months](https://docs.earthindex.ai/monthly-search-beta/monthly-monitor.md).
* You know the limits below.

## Steps

1. Open the **Monthly Search** tab. At the bottom of the panel, the **Auto Run New Months** card shows **Off** and "Turn on to run each new month automatically."
2. Click **Manage**. The dialog shows "First run if turned on today (estimated)" with a date and the month it covers, such as "Covers November 2026".

   ![The automatic monthly run dialog.](https://182773137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIQB2eToY1Iv2IH6cERjn%2Fuploads%2Fgit-blob-1bf302a84b2bb54ba853c7ce4cab7d29f08618b6%2Fautomatic-monthly-run.jpg?alt=media)
3. Read **How it works**:
   * "Each run covers the month that just ended." Auto runs never process the current month, because its imagery is complete only after it ends. Each run starts early the following month.
   * "Uses your settings from when you turn it on." Auto runs use your current detector, sensitivity and seasonality settings.
   * "Counts toward your monitored projects limit."
4. Under **Email updates**, "New results will be emailed to" your account email by default. To use another address, click **Use a different email** and type it under **Send results to**. To go back, click **Use my account email**. To get no email, tick **Don't email me about new results**.
5. Click **Turn on auto runs**.
6. To change the email setting, click **Manage**, edit **Email updates**, then click **Save changes**.
7. To apply new sensitivity or seasonality settings, change them on the **Monthly Search** tab. Click **Manage** and **Turn off auto runs**, then **Manage** and **Turn on auto runs** again.
8. To turn off auto runs, click **Manage**, then **Turn off auto runs**. Months that already ran stay in your project.

## Limits that apply

* **Monitored projects.** Turning on auto runs counts the project. Full Access allows 3 by default, and Open access allows 0. The Earth Index team can set a different limit for your account. Turning auto runs off frees the slot.
* **Queue.** Up to 3 months can be queued or running at once.
* **Months.** You can run January 2024 up to the latest month that has ended.
* **Processed months.** Running months also draws on an allowance of processed months, which Full Access sets to 18 by default and does not renew by default. A month over an area larger than 250,000 km² counts as more than one.

The app shows no usage meter for these, and the **Quotas** dialog does not list them. For account limits, see [Limits and quotas](https://docs.earthindex.ai/reference/limits-and-quotas.md).

## What to expect

* The card shows **On** and "Next run: December 1, 2026", with your own date. The date is an estimate.
* After a run, the new month appears on the timeline like any processed month.
* If email is on, the address you chose gets an email with a link back to the project. It covers a finished run and a run that did not finish. If you tick **Don't email me about new results**, the dialog says "You won't get emails about auto runs. New results will still appear in this project."

## If something goes wrong

| Symptom                                                   | Fix                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No email arrived                                          | Results are saved in the project either way. In **Manage**, check the address and that **Don't email me about new results** is off. Check spam. The address must be valid: "Enter a single, valid email address."                                                                                                                   |
| A limit stopped a run, and no email arrived               | No email is sent. A month that did not run has no results, and its timeline cell shows **Month Not Run**. If you start a run yourself, a yellow notice names the limit and ends with your limit in brackets, such as "quota exceeded: maximum inference months limit reached (18)". To raise a limit, email <info@earthgenome.org>. |
| A yellow notice about monitored projects when you turn on | You reached the monitored projects limit. Turn off auto runs in another project, or ask about a higher limit.                                                                                                                                                                                                                       |
| **Turn on auto runs** is disabled                         | Run a month first and wait for it to finish, then open **Manage** again.                                                                                                                                                                                                                                                            |
| The current month was not processed                       | By design. Auto runs never process the current month.                                                                                                                                                                                                                                                                               |
| Your new sensitivity is not used                          | Turn auto runs off and on again to apply it.                                                                                                                                                                                                                                                                                        |

## Related

* [Run and compare months](https://docs.earthindex.ai/monthly-search-beta/monthly-monitor.md)
* [Monthly Search overview](https://docs.earthindex.ai/monthly-search-beta/overview.md)
* [Limits and quotas](https://docs.earthindex.ai/reference/limits-and-quotas.md)
