> ## Documentation Index
> Fetch the complete documentation index at: https://atlas.rebuildingus.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduled Scout runs

> Configure repeatable local discovery targets and run them on a schedule.

Schedules are local Scout configuration. Use them when the same computer should
run the same place-and-issue targets repeatedly.

For Atlas-assigned jobs, use [worker mode](/docs/scout/worker) instead.

## Configure The Schedule

Enable a schedule and set the cron expression:

```bash theme={null}
scout config schedule set --enabled --cron "0 8 * * 1"
```

Add targets:

```bash theme={null}
scout config schedule target add \
  --location "Las Vegas, NV" \
  --issues housing_affordability,public_transit
```

List targets:

```bash theme={null}
scout config schedule target list
```

Scheduled place-and-issue runs need a working model and search connection when
Scout must find new sources:

```bash theme={null}
scout doctor --require search-discovery
```

## Run Once

Run all configured targets once:

```bash theme={null}
scout schedule run-once
```

Use this before leaving the scheduler running.

## Start The Scheduler

```bash theme={null}
scout schedule start
```

The scheduler runs until interrupted. Use a process manager such as launchd,
systemd, or a supervised terminal session when the computer should keep running
after logout.