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

# Troubleshooting

> Most issues with your D0 Bot can be resolved with a simple restart. This page covers common problems and how to fix them.

Most issues with your D0 Bot can be resolved with a simple restart. This page covers common problems and how to fix them.

## Bot Not Responding on Telegram

**Symptoms:** You send a message to your bot on Telegram, but it doesn't reply.

**Common Causes & Solutions:**

### 1. Check if Your Bot is Online

Go to the **D0 Dashboard** and check your bot's status:

* **Online (green)** — Bot should be working. Try restarting (see below).
* **Hibernated (yellow)** — Your bot is sleeping. Click **Wake Up**, or simply send a message on Telegram — the bot will auto-resume in 1-2 minutes.
* **Error (red)** — There's an issue. Click **Restart** to fix it.

### 2. Restart Your Bot

If your bot shows as "Online" but isn't responding:

1. Go to the D0 Dashboard
2. Click the **Restart** button
3. Wait about 30 seconds
4. Try sending a message again on Telegram

Restarting is the fastest way to fix most issues. It doesn't delete any of your data or settings.

### 3. Check Your Telegram Authorization

Make sure the Telegram account linked to your bot matches your actual Telegram account:

* Your bot only responds to messages from the linked account
* If you connected the wrong Telegram account during onboarding, you'll need to re-link from Dashboard Settings

## Provisioning Stuck

**Symptoms:** During onboarding, the provisioning progress is stuck on one step.

**Solutions:**

1. **Wait a bit longer** — Provisioning can take up to 3 minutes
2. **Refresh the page** — Your progress won't be lost; the page will show the current status
3. **If stuck for more than 3 minutes** — Click the **Retry** button

## Bot Shows "Error" Status

**Symptoms:** The Dashboard shows your bot in an Error state.

**Solutions:**

1. Click the **Restart** button on the Dashboard
2. Wait about 30 seconds for the restart to complete
3. If the error persists after 2-3 restart attempts, wait a few minutes and try again

<Tip>
  Most errors are temporary and resolve themselves with a restart. If the problem keeps coming back, check the error message shown on the Dashboard for specific details.
</Tip>

## Can't Sign In

**Symptoms:** You can't log in to the D0 Dashboard.

**Solutions:**

1. Make sure you're using the same Google account you registered with
2. Try clearing your browser cookies and cache
3. Try a different browser or incognito mode
4. Check if you have any browser extensions blocking the login popup

## Telegram Connection Issues

**Symptoms:** Error when connecting Telegram during onboarding.

**Solutions:**

| Issue                      | What to Do                                                                                                                          |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| "Connection failed"        | Click **Retry Connection** to generate a new authorization link                                                                     |
| "Connection expired"       | The Telegram authorization link expired. Click **Retry Connection** for a fresh link                                                |
| Connected but not detected | Make sure you tapped **Authorize** in the Telegram tab. If you closed the tab without authorizing, click **Connect Telegram** again |

<Tip>
  **Custom Bot Token**
  If you're on a Dedicated plan and use a custom Telegram bot token: if the token is revoked in BotFather, your bot will stop working. Create a new bot token and update it in Dashboard → Settings → Bot.
</Tip>

## Slow Responses

**Symptoms:** Your bot takes a long time to reply.

This can happen when:

* Your bot was hibernated and is auto-resuming (first message takes 1-2 minutes)
* Your bot is analyzing complex data (like a detailed chart image)
* Multiple data sources are being queried (like a full token analysis)
* The AI is processing a complicated question

Most responses should arrive within 5-15 seconds. Chart analysis may take up to 30 seconds.

## Getting Help

If none of the above solutions work:

1. Note down the **error message** from the Dashboard (if any)
2. Note your **bot's username** (e.g., @my\_trading\_bot)
3. Contact support through the D0 Dashboard or the Donut community channels

We typically respond within a few hours.