# Troubleshooting

<tip>
    Always check the container and browser logs for more specific error messages
</tip>

## Authentication Issues

<procedure title="I can't log in with OAuth/OIDC?" id="procedure-i-cannot-log-in-with-oauth">
    <step>Verify your OAuth provider's configuration. <a href="authentication-setup.md" anchor="openid-connect-settings-auth-openid-connect">See the OAuth documentation</a></step>
    <step>Check if the callback URI you set in your OIDC providers settings is correct. <a href="authentication-setup.md" anchor="redirect-uri">See the callback URI documentation</a> </step>
    <step>Check the frontend url in your config file. It should match the URL you use to access MediaManager.</step>
</procedure>

<procedure title="I cannot log in?" id="procedure-i-cannot-log-in">
   <step>Make sure you are logging in, not signing up.</step>
   <step>Try logging in with the following credentials: 
        <list>
          <li>Email: admin@mediamanager.local or admin@example.com</li>
          <li>Password: admin</li>
        </list>
   </step>
</procedure>

## Hard linking Issues

- Make sure you are using only one volumes for TV, Movies and Downloads.
  <a href="https://raw.githubusercontent.com/maxdorninger/MediaManager/refs/heads/master/docker-compose.yaml"> See the configuration in the example <code>docker-compose.yaml</code> file.</a>

The reason is that hard linking only works within the same filesystem. If your downloads are on a different volume than
your media library, hard linking will not work.

## Torrent Search Issues

<procedure title="I get no search results for torrents?" id="procedure-i-get-no-search-results">
    <step>Try switching to the advanced tab when searching for torrents.</step>
    <step><a href="Indexer-Settings.md">If you use "slow" indexers, try increasing the timeout threshold.</a></step>
    <step>If you still don't get any search results, check the logs, they will provide more information on what is going wrong.</step>
</procedure>

## Import and download Issues

- If you configured a category with a special save path,
  <a href="qBittorrent-Category.md">carefully read this page about MM with qBittorrent save paths.</a>

<note>If it still doesn't work, <a href="https://github.com/maxdorninger/MediaManager/issues">please open an Issue.</a> It is possible that a bug is causing the issue.</note>