Manual 0.8.0

Run watch unattended

Turn the watch loop on, then leave Revetly reading its sources without you.

Before you start

Configuration page

  1. Open the configuration page. If it is not open, run revetly config and open the address it prints.

    You should see Watch and retries.

  2. Go to Watch and retries.

  3. Turn on Watch loop.

  4. Select Save.

    You should see Watch loop: running on the instance card.

  5. Read the line under the loop's state. Revetly has run the first tick by the time the page comes back.

    You should see Last tick on the instance card.

Command line

The container's command is revetly supervise. With the watch loop switch on (enabled = true under [watch]) and a positive interval, it starts one revetly watch loop per project itself and restarts a loop that exits, with a bounded backoff. Step 4 is the by-hand path for a switch that is off: a loop started that way is not restarted when it exits or when the container restarts. On an instance declaring several projects, a loop started by hand watches the default project alone, and revetly watch --project names any other.

  1. In revetly.toml at the project root, declare the seconds under [watch]:

    # revetly.toml
    [watch]
    interval = 600
    
  2. Read the policy this instance now declares:

    revetly status
    
    Watch: a pass every 10m …
    
  3. Run one tick by hand and watch it through.

    revetly watch --once
    

    If the provider key is not set, the tick fails on the key rather than on a source, and the key belongs in .env at the project root.

  4. Start the loop inside the engine service:

    docker compose exec -d revetly revetly watch
    
  5. Read the loop back from a second shell:

    docker compose exec revetly revetly status
    

    You should see the loop is running here.

Troubleshooting

Next steps