diff --git a/docs/getting-started/setup.md b/docs/getting-started/setup.md
index 913a2bcc..973fdf8a 100644
--- a/docs/getting-started/setup.md
+++ b/docs/getting-started/setup.md
@@ -96,6 +96,10 @@ like any other: open the swarm UI start page and click the paperclip, which
 opens the create form with `ruth` filled in. The form declares her, creates
 her config repo and deploys her to the hive you pick.
 
+The swarm declares a new agent `paused`, so without a further step ruth runs
+but drives no turns. Open `/agents` in the swarm UI and set her `up` from her
+card.
+
 On a hive that already has a ruth container from an earlier release, create
 her once the same way, so that her config repo and store identity exist. The
 container keeps starting with the hive meanwhile.