Need Help?

If you're having trouble with Streamarr, here's how to get support.

---

Before Asking for Help

1. Check the Documentation — Many common questions are answered in these docs

2. Search Existing Issues — Your problem may have been reported and solved

3. Check the FAQ — See Frequently Asked Questions

4. Gather Information — Collect logs and error messages before asking

---

Getting Help

GitHub Discussions

For questions, feature ideas, and general discussion:

GitHub Discussions

This is the best place for:

• Usage questions

• Configuration help

• Feature requests

• Showing off your setup

GitHub Issues

For bug reports only:

GitHub Issues

Please do not use GitHub Issues for questions or support requests. Use Discussions instead.

When reporting a bug:

1. Search existing issues first

2. Use the bug report template

3. Include all requested information

4. Provide reproduction steps

---

How Can I Share My Logs?

When asking for help, logs are essential for diagnosing issues.

Location

Logs are stored in your config directory:

config/logs/streamarr-YYYY-MM-DD.log    # Main application logs

Docker

To view logs directly:

# View container logs
docker logs streamarr

# Follow logs in real-time
docker logs -f streamarr

# View last 100 lines
docker logs --tail 100 streamarr

To copy log files from the container:

docker cp streamarr:/app/config/logs/. ./logs/

Sharing Logs

Review logs before sharing! Remove any sensitive information such as:

• API keys

• Passwords

• Email addresses

• IP addresses (if concerned about privacy)

For sharing logs:

1. Pastebin Services — Use Pastebin, GitHub Gist, or similar

2. File Attachment — Attach as a file in GitHub Issues/Discussions

3. Code Blocks — For short logs, use code blocks in your message

---

Information to Include

When asking for help, include:

Basic Information

• Streamarr version (found in Settings → System)

• Installation method (Docker, Docker Compose)

• Operating system

• Browser (for UI issues)

Problem Description

• What you expected to happen

• What actually happened

• Steps to reproduce the issue

• Any error messages

Logs

• Relevant log entries (see above)

• Browser console errors (for UI issues)

• Network requests (for API issues)

Configuration

• Relevant settings (without sensitive data)

• Docker command or compose file

• Reverse proxy configuration (if applicable)

---

Debug Mode

For more detailed logs, you can increase the log level:

# Docker CLI
docker run -e LOG_LEVEL=debug ...

# Docker Compose
environment:
  - LOG_LEVEL=debug

Available log levels:

• error — Errors only

• warn — Warnings and errors

• info — General information

• debug — Detailed debugging information (default)

---

Common Solutions

Restart the Container

Many issues can be resolved with a restart:

docker restart streamarr

Clear Cache

Clear application caches in Settings → Jobs & Cache.

Check Connectivity

Verify Streamarr can reach external services:

# Enter the container
docker exec -it streamarr sh

# Test connectivity
ping your-plex-server
curl -I http://your-radarr:7878

Verify Configuration

Check config/settings.json for obviously incorrect values. You can manually edit this file if needed (restart required).

---

Contributing

If you'd like to help improve Streamarr:

• Contributing Guide

• Code of Conduct

We welcome:

• Bug fixes

• New features

• Documentation improvements

• Translations