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

# Support & Troubleshooting

> Get help with Zenflow — common fixes, log locations, and how to reach support.

## Get Help

<CardGroup cols={3}>
  <Card title="Discord Community" icon="discord" href="https://discord.com/invite/zencoder">
    Ask questions, share workflows, and get real-time help from the community and Zencoder team.
  </Card>

  <Card title="Email Support" icon="envelope" href="mailto:support@zencoder.ai">
    For account issues, billing, or anything sensitive — **[support@zencoder.ai](mailto:support@zencoder.ai)**
  </Card>

  <Card title="YouTube Tutorials" icon="youtube" href="https://www.youtube.com/@zencoderai">
    Video walkthroughs of Zenflow features, workflows, and setup guides.
  </Card>
</CardGroup>

***

## Common Issues

<AccordionGroup>
  <Accordion title="Agent not responding">
    **Causes:** Agent authentication expired, network interruption, or service unavailable.

    **Fix:** Sign out and sign back into the agent in **Settings → Saved presets**. Check your internet connection and retry.
  </Accordion>

  <Accordion title="Task stuck in progress">
    **Causes:** Long-running verification step, network timeout, or workspace lock.

    **Fix:** Check task logs for the last completed step. If stuck for more than 10 minutes, cancel and retry the task.
  </Accordion>

  <Accordion title="Installation failures">
    **Causes:** Insufficient permissions, conflicting software, or corrupted download.

    **Fix:** Run the installer as administrator (Windows) or with `sudo` (macOS). Temporarily disable antivirus if the download is being blocked.
  </Accordion>

  <Accordion title="Workspace or git errors">
    **Causes:** Git conflicts, permission issues, or insufficient disk space.

    **Fix:** Ensure you have write permissions and at least 2GB free disk space in your workspace directory. Run `git status` in the worktree to check for conflicts.
  </Accordion>
</AccordionGroup>

***

## Log Files

Zenflow stores logs locally on your machine. Logs are never transmitted automatically.

| Platform    | Location                                                    |
| ----------- | ----------------------------------------------------------- |
| **macOS**   | `~/Library/Application Support/zenflow-desktop/logs/`       |
| **Windows** | `C:\Users\<username>\AppData\Roaming\zenflow-desktop\logs\` |

***

## Reporting an Issue

When contacting support, include the following to help us resolve your issue quickly:

<Steps>
  <Step title="Gather basic info">
    * **App version**: Settings → About (e.g., `Zenflow Desktop v1.2.3 build 456`)
    * **OS**: Version and architecture (e.g., `macOS 14.2.1 - Apple Silicon M2`)
  </Step>

  <Step title="Document the issue">
    * **Timestamps**: When did it happen? Include your timezone.
    * **Steps to reproduce**: What were you doing when the error occurred?
    * **Screenshots or recordings**: Capture any error messages or unexpected behavior.
  </Step>

  <Step title="Attach logs">
    Grab the relevant log files from the locations above and attach them to your report.
  </Step>

  <Step title="Send it">
    Email **[support@zencoder.ai](mailto:support@zencoder.ai)** or post in **#support** on [Discord](https://discord.com/invite/zencoder).
  </Step>
</Steps>

<Note>
  If you're behind a VPN, proxy, or corporate firewall, mention that in your report — it often affects agent connectivity.
</Note>