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

# Troubleshooting

> Find what you see in your Scrolly console, learn what it means and what to do next.

Start with what you see, find it below, and follow the steps. Words in `code style` are the exact names Scrolly shows in the console, in emails or in `scrollyctl` output.

> [!TIP]
>
> Open **Needs you** first. It lists everything only a person can fix, each with its button. See [Needs you](https://docs.tryscrolly.com/guides/activity.md#needs-you).

## Signing in

> [accordion] I never got my sign-up code
>
> Check spam for an email from `notifications@tryscrolly.com`. On **Check your email**, enter the six-digit code. If it expired or didn't arrive, choose **Send a new code** after 30 seconds. If the address was a typo, choose **Use a different email**.

> [accordion] I forgot my password
>
> On the sign-in page choose **Forgot password?**, enter your email and choose **Send link**. The link works once, for 1 hour. It signs you out of every browser, so sign in again with the new password. If the link says **Link expired**, choose **Get a new link**.

## The Mac

> [accordion] The Mac shows Offline, or you got a 'Mac is offline' email
>
> Under **Devices**, on **Macs**, the Mac's page shows a **Connected** or **Offline** badge. Scrolly emails once when a Mac has been silent past your threshold (10 minutes by default, 2 minutes at the least, set by an Admin under **Settings › Emails**), and once more when it comes back. A Mac that is offline cannot run anything. A run that was in progress on it is stopped, and the phone is checked once the Mac is back.
>
> **1. Check the Mac is awake and online**
>
> A sleeping Mac drops every phone on it. See "My Mac goes to sleep" at the end of this section.
>
> **2. Check someone is logged in on the Mac**
>
> FileVault stays on, so a Mac that restarted (an update or a power cut) waits at its login screen and runs nothing until someone logs in. Scrolly never recommends automatic login.
>
> **3. Check Scrolly may run in the background**
>
> In System Settings, open Login Items & Extensions and make sure Scrolly is on under Allow in the Background. If it is off, nothing runs.
>
> **4. Restart Scrolly's services**
>
> In Terminal, run the command below, wait ten seconds, then check the Mac's page again.
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
> scrollyctl restart
> ```
>
> If the Mac's page says **No checklist from this Mac yet** while it is connected, the Mac's software is too old to report its setup and needs an update. Install the current Scrolly Installer.

> [accordion] The Mac was never linked, or a link code is refused
>
> Link a Mac with the Mac app: choose **Download for Mac**, open the installer, then open the page the app shows and check the code matches the one on the Mac before you choose the **Approve** button with the Mac's name. Only an Admin can approve.
>
> * `This code isn't waiting`: the code expired, was already used, or was never started. Open the Scrolly app on the Mac to show a new one. A link code lasts ten minutes and works once.
> * `Only an Admin can link a Mac`: ask an Admin of your organization to open the page, or to give you the Admin role.
> * `You're signed out`: sign in again, then reopen the page from the Mac.
> * The installer says `This installer is for Intel Macs` or `for Apple silicon Macs`: you have the other chip's version. If **Download for Mac** offers another build, choose the one for your chip.
> * **Open Scrolly** does nothing: open Scrolly from Applications. If it isn't there, download it under **Add a Mac** and open the installer.
> * `<Mac> didn't finish`: it was approved, but the Mac didn't pick it up in time, usually because it was asleep. Wake it, open Scrolly and click **Link this Mac**.
> * `<Mac> wasn't added`: it was approved, but couldn't join. Your plan may have no room for another Mac (see **Settings › Billing**), or the person who approved it is no longer an Admin. Fix that, then open Scrolly on the Mac and click **Link this Mac**.
> * The page stays on `Connecting…`: the Mac is approved but not online yet. Check it is awake and on the internet; the page moves on by itself once it is.
>
> With a pairing code instead (Add a Mac, Advanced), run `scrollyctl enroll <code>` on the Mac. A pairing code also lasts ten minutes and works once. If `scrollyctl` says `not_enrolled`, the Mac is not linked yet. Create a code in the console and run `scrollyctl enroll` again.

> [accordion] scrollyctl says provider\_unreachable, needs\_terminal or refused
>
> | It says | Do |
> | - | - |
> | `not_enrolled` | Create a pairing code in the console (Add a Mac), then run `scrollyctl enroll <code>`. |
> | `provider_unreachable` | The provider is not running. Run `scrollyctl restart` and check again. If it says the provider was set up before it could report its setup status, install the current Scrolly Installer, then run `scrollyctl enroll` again with a new code. |
> | `needs_terminal` | The step needs your Mac password, which only you type. Open Terminal and run the command it names. |
> | `refused` | The name is not a setup step, or the step is not one a command does. Its message says who does it. |
>
> A step that stays `[?]` has not been read yet. Keep the phone unlocked and connected, and check the Mac is online. See [scrollyctl](https://docs.tryscrolly.com/reference/scrollyctl.md).

> [accordion] I can't open the Scrolly Installer: macOS blocks it
>
> The download card shows a **Test build** badge when the installer is not signed with Scrolly's developer certificate yet, and macOS asks before opening it. Download the current release from **Add a Mac**.
>
> **1. Open it from Finder**
>
> In Finder, open Downloads, then right-click (or Control-click) the installer and choose Open.
>
> **2. Confirm**
>
> Click Open in the box that appears.
>
> **3. If macOS offers only Done**
>
> Open System Settings, then Privacy & Security, and choose Open Anyway next to the installer.
>
> **Advanced** shows the file's SHA-256. Compare it with `shasum -a 256` on the Mac if you want to check the download. No **Download for Mac** button? On a Mac that already has the app, click **Open Scrolly**, or use a pairing code under **Advanced**.

> [accordion] My Mac goes to sleep
>
> A sleeping Mac disconnects every phone plugged into it, so nothing scheduled runs. Look for **Never sleeps** on **This Mac**. Its reason reads `This Mac sleeps after N minutes idle, which drops every phone on it`.
>
> Choose **Fix** beside **Never sleeps** and follow the guide. You can also run this in your own Terminal window:
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
> scrollyctl setup mac_never_sleeps
> ```
>
> It asks for your Mac password in your Terminal. Scrolly never sees it. If the sleep setting cannot be read the step shows unknown, and `pmset -g` shows it.

## Setting up a phone

Open the phone's **Set it up** button to resume. For the Mac's reading of each step, run `scrollyctl setup status`.

> [accordion] A step won't turn done
>
> On **Phone settings**, choose **Done** once you've finished each setting. During WDA installation, Scrolly checks the install, trust and startup itself. Keep the phone connected and unlocked and follow any prompt on the install step.

> [accordion] The wrong handle was added
>
> Open the account from **Accounts** and change its handle, or archive it and add the right one.

> [accordion] Test this phone failed
>
> The test is optional. A phone can post without it. To try again, keep the phone unlocked and leave it alone, then **Test again**. The test only makes a private draft. Open **Activity** to see the step where it stopped.

> [accordion] Developer setup (WDA phones)
>
> See [Developer setup](https://docs.tryscrolly.com/guides/older-ios-advanced-setup.md). The install step tells you when to trust the developer, unlock the phone or update the Mac app.

## A phone isn't running

> [accordion] Not connected or Not responding
>
> Check the cable, unlock the phone, and check the Mac shows **Connected** on **Macs**.

> [accordion] Not running
>
> Open the phone. **Why it's not running** lists each reason with its fix. See [Phones](https://docs.tryscrolly.com/guides/phones.md#why-its-not-running).

> [accordion] Everything is paused
>
> An Admin chose **Pause all**. An Admin chooses **Resume** in the banner.

> [accordion] Checking itself after a problem
>
> After a run fails, the phone checks itself and carries on. If the check keeps failing, the phone waits for **Resume** in **Needs you**.

## Posts

> [accordion] A post is waiting
>
> Open it on **Posts**. It says why: for example **Phone busy**, **Phone offline**, **Outside hours**, **Daily limit**, **Account warming**, **Autopilot off** or **Needs you**.

> [accordion] Did @handle's post go up?
>
> Scrolly couldn't tell. Check the account in the app, then **Answer** in **Needs you**. Scrolly holds that post until you answer.

> [accordion] A post didn't finish
>
> **Run again** or **Dismiss** in **Needs you**. The phone keeps working either way.

> [accordion] Missed, Didn't post or Time ran out
>
> **Missed**: it couldn't start in time. **Pick a new time**. The others show on **Needs you** for seven days; use **Post again**.

## Emails

> [accordion] I didn't get an email
>
> Look for mail from `notifications@tryscrolly.com`, including in spam. In **Settings › Emails**, check who receives those alerts. With nobody picked, every Admin gets them, and so does each Member with access to the phone or account. Scrolly sends one email per problem, not one per retry.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.