A Host restart is a lifecycle action, not an ordinary troubleshooting click. Restart an exact task-owned nonproduction test or verification Host directly when it belongs to your assigned task; keep production, shared, and out-of-scope Hosts behind their operator boundary. Then compare visible before-and-after state instead of assuming every task resumed.

1. Confirm the restart authority and exact target

Before opening the restart control, classify the exact Host. An assigned, task-owned, nonproduction test or verification Host can be restarted directly as ordinary task execution. Production, shared, ambiguous, or another task's Host is outside that authority.

2. Record a safe before-state

Start signed in on Sessions, with the ready connection state visible on the exact task-owned test Host.

  1. List the display names of the Sessions that must return, and count how many times each appears.
  2. Open each important Session and note its last completed visible message or result. Do not copy private content into public evidence.
  3. For a Session with Loops, open the chat header’s More Options menu and choose Loop. Record each Loop definition, its enabled or disabled toggle, and its visible Last and Next values.
  4. Return to Sessions. Wait for active provider replies, terminal commands, Loop turns, or scheduler work to reach a safe stopping point whenever possible.

Checkpoint: you can identify the intended Host, the exact Session set, the last completed work in each important Session, and the pre-restart Loop states without exposing a credential, private URL, local path, or message content.

3. Restart the exact task-owned Host once

Full Host Preferences view on the task-owned test Host, with Connected and Direct Host context, the Restart Host control, and its restore helper visible without an unsaved-change warning.
Before the one authorized restart: the task-owned test Host is Connected by Direct Host in Host Preferences, where Restart Host and the session-and-Loop restore helper are visible and no unrelated unsaved-change warning is present.
  1. Open the Oysterun menu and choose Host Preferences.
  2. Find Restart Host. Read the helper copy, then recheck the task-owned Host identity and nonproduction origin.
  3. If Host Preferences contains unrelated unsaved changes, do not restart. Resolve the draft first; Oysterun reports Save Host Preferences changes before restarting Host.
  4. Select Restart Host once.
  5. Expect Preparing restore state for existing sessions and enabled loops..., followed by Restart scheduled.
  6. Stay on the handoff. It says Please wait while Oysterun restarts. This usually takes about 30 seconds. and counts down until you are logged out.

Do not select restart again, refresh during the countdown, switch endpoints, or send new Session work while the handoff is active.

4. Wait for the same Host to become ready

Full This Host sign-in gate for Oysterun after restart, showing Oysterun is ready, the password-only form, and Open Oysterun without exposing a credential.
Terminal restart gate: the same This Host / Oysterun destination says “Oysterun is ready. Sign in again.” and offers the normal password-only Open Oysterun form; no password is exposed.
  1. Keep the restart gate open. During downtime it can show Oysterun is restarting. Sign in will be available when the Host is ready. or Waiting for the Host to become available before signing in.
  2. Do not repeatedly submit the password or initiate another lifecycle action.
  3. Continue only when the page says Oysterun is ready. Sign in again.
  4. Sign in through the normal password-only form and wait for Sessions.
  5. Confirm that the connection indicator returns to Connected on the same intended origin.

5. Verify Sessions and interrupted work

Full restored Session p128-v-a-p03-restore-a1 with its single retained checkpoint request and response, preserved history, and usable composer visible after restart.
Restored work check: Session p128-v-a-p03-restore-a1 retains one “P128 A-P03 checkpoint complete” request and one matching completion, with conversation history and the Send a message composer intact and no duplicate prompt.
  1. Compare the Sessions list with your before-state. Each eligible Session that was live or ready should appear once, not zero times or as a duplicate.
  2. Open each important returned Session only after it is available.
  3. Confirm that its preserved conversation reaches the same last completed message or result you recorded.
  4. Confirm that Oysterun did not automatically resend the previous prompt.
  5. Inspect any provider reply, terminal command, Loop turn, scheduler run, or shell work that was active at shutdown. Restart can mark such work interrupted; it does not replay it.

A returned Session is a freshly resumed provider runtime backed by its existing conversation, not an assumption that in-progress work finished while the Host was down.

6. Verify every Loop before enabling it

Full Loop panel for the restored Session, showing the retained one-hour checkpoint definition, cleared Last and Next values, and its toggle visibly Disabled after restart.
Post-restart Loop check: the restored Session still lists its one-hour “P128 A-P03 loop checkpoint” definition, while Last and Next are cleared and the only toggle is visibly Disabled.
  1. From the restored Session chat, open More Options and choose Loop.
  2. Confirm that the expected Loop definitions are still listed.
  3. Confirm that every toggle is Disabled. Any pending occurrence and old Next time are cleared across the restart boundary.
  4. Check the last visible result before deciding whether missed work still needs to run.
  5. Enable a Loop explicitly only if you still want it scheduled. Enabling starts a fresh cadence; Oysterun does not catch up missed occurrences.

Recover safely and know when to stop

Safe stop: resume ordinary work only after the exact Host is Connected, expected Sessions are present once, conversation checkpoints match, and every Loop has been reviewed in its disabled post-restart state.