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

# Settings & Troubleshooting

> Tune the Stru AI Desktop Client to your workflow and resolve common issues

## Settings Tour

Open Settings from the **gear icon** (or your profile) in the header.

### General: appearance, dictation, and account

* **Theme** (Light/Dark) and **Palette** color presets.
* **Design standard**: the default building-code region for your conversations (US, Eurocode, Australia/NZ, Canada, Philippines, Singapore).
* **Dictation**: pick which microphone the composer's voice input uses.
* **Account**: your signed-in profile, your usage meter, and **Logout**.
* **Reset Configuration**: clears preferences, working directories, and environment paths, but keeps you signed in.

### Agents: how runs behave

* **Show advanced stats**: adds elapsed time and step count to the status bar.
* **Agent step limit**: how many steps a run takes before pausing for your go-ahead.
* **Enter while agent is working**: choose whether a mid-run message **steers** the current response or **queues** for after it finishes.
* **Live thought panel**: show just the latest reasoning or the full log.
* **Formatting standards**: point the agent at your [standards folder](/how-to/standards-folder) so deliverables follow your templates.

### SAP2000, ETABS & MathCAD: software and folders

Each tab shows a **working directory** picker and the **detected versions** of that software with a refresh action. Select which version the agent should use if you have more than one. The MathCAD tab adds toggles to auto-open generated files and to overwrite files when editing.

### Software: version and updates

Shows the app's current version, a **Check for updates** button, and live update status. When an update has downloaded, **Update now** installs it with a quick restart.

### Python: the app's environment

The app manages its environment automatically. If needed, this tab lets you auto-detect an installation, pick from the ones it found, or download and install a fresh one with one click.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The app won't start, or shows 'The previous launch did not finish successfully'">
    Click **Continue** to launch anyway. If it keeps happening, click **Open download page** and run the latest installer over your existing install. That resolves a stuck update in one step.
  </Accordion>

  <Accordion title="Stuck on 'Setting up your environment'">
    Close and reopen the app. Setup resumes automatically. Check that your internet connection (or firewall) isn't blocking downloads. If it fails repeatedly, reinstall with the latest installer.
  </Accordion>

  <Accordion title="I clicked Update and the app didn't come back">
    Reopen it from its icon. It resumes on the new version. If it truly won't open, run the latest full installer from the download page over the existing install.
  </Accordion>

  <Accordion title="The web app says my ETABS/SAP2000 connection is offline">
    Make sure the desktop app is **open and signed in** on the Windows machine with the software installed, and the **Client** pill is green. If you recently switched accounts, fully quit and reopen the desktop app once, then retry.
  </Accordion>

  <Accordion title="Settings shows no SAP2000/ETABS version (or the wrong one)">
    The app detects software in the default install locations (`C:\Program Files\Computers and Structures\...`). Click the refresh action in **Settings → SAP2000 / ETABS**, then select the right version from the list.
  </Accordion>

  <Accordion title="The Client pill stays gray">
    Normal for a few seconds after launch while the client starts. If it stays gray past a minute, check your internet connection and choose **Restart client** from the pill's menu, or restart the app.
  </Accordion>

  <Accordion title="'Out of credits' or 'Response interrupted' banners">
    **Out of credits** means you've hit your usage limit. The banner shows when it resets, and your live balance is under **Settings → General → Account**. **Response interrupted** means the run stopped early. Hit retry or send the message again.
  </Accordion>
</AccordionGroup>

## Sending Logs to Support

If support asks for logs, zip and attach this folder from your Windows user profile:

```text theme={null}
%APPDATA%\structures-ai\logs\
```

Paste that path into the File Explorer address bar and press Enter to jump straight to it.

<Info>
  **Questions?** Email **[support@stru.ai](mailto:support@stru.ai)** or [book a call](https://cal.com/bhosh).
</Info>