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

# Troubleshoot Solara: Fixes for the Most Common Issues

> Resolve the most common Solara issues including commands not responding, missing permissions, logging not working, and auto-mod false positives.

Most Solara issues come down to missing permissions or a configuration step that was skipped during setup. Work through the relevant section below, and if the problem persists, the support Discord is available for direct help.

<AccordionGroup>
  <Accordion title="Solara isn't responding to commands">
    1. Check that Solara has **Send Messages** and **Embed Links** permissions in the channel where you are running the command.
    2. Confirm that Solara's role is not being overridden by a role that restricts it. Open **Server Settings > Roles** and verify the permission hierarchy.
    3. Run `/ping` or another simple command to confirm whether the bot is reachable at all.
    4. If you changed the prefix, remember that slash commands (e.g. `/ban`, `/config`) always work regardless of prefix — try using `/` commands directly.
  </Accordion>

  <Accordion title="Auto-mod is flagging legitimate messages">
    1. Adjust the auto-mod sensitivity in `/config` or from the **Moderation settings** panel in the dashboard — lower the sensitivity to reduce false positives.
    2. Add trusted roles to the auto-mod bypass list so staff or verified members are not affected by filters.
    3. Review the banned words list in the dashboard and remove or refine entries that are matching unintended messages.
  </Accordion>

  <Accordion title="Logging isn't working">
    1. Run `/logs setup` to confirm that a channel has been assigned for the event type that isn't logging.
    2. Check that Solara has **View Channel** and **Send Messages** permissions in the log channel you have assigned.
    3. Check whether the source channel is in the `/ignore-channel` list — ignored channels are excluded from all logging.
  </Accordion>

  <Accordion title="Auto-role isn't assigning roles to new members">
    1. Run `/config` and verify that `/autorole` is configured and enabled.
    2. Open **Server Settings > Roles** and confirm that Solara's role is positioned higher in the list than the role it is trying to assign. Discord prevents bots from assigning roles above their own.
    3. Confirm that Solara has the **Manage Roles** permission.
  </Accordion>

  <Accordion title="The dashboard link doesn't work">
    1. Dashboard links are personal and expire shortly after they are generated. Run `/dashboard` again to receive a fresh link.
    2. Make sure you are logged into Discord in the browser you are using to open the link. The dashboard uses your Discord session to verify your identity and server permissions.
  </Accordion>

  <Accordion title="Commands are returning permission errors">
    1. Open **Server Settings > Roles** and confirm that Solara's role is positioned above the roles it needs to manage. Discord enforces a strict role hierarchy for all role-related actions.
    2. For moderation commands to work correctly, Solara needs the **Kick Members**, **Ban Members**, or **Moderate Members** permission depending on the command being used.
  </Accordion>
</AccordionGroup>

<Note>
  If none of these solutions resolve your issue, join the support Discord at [discord.gg/UrXY3hDCyP](https://discord.gg/UrXY3hDCyP) for direct assistance from the team.
</Note>