Frequently Asked Questions 🤔
General Questions
Why another media server script?
YAMS was born from a simple goal: Create a media server that’s so easy to use, your non-tech-savvy family members could handle it! While there are other solutions out there, YAMS focuses on simplicity and automation without sacrificing power.
Why these specific software choices?
YAMS is opinionated by design. Every choice was made to create a reliable, user-friendly experience. If you’re curious about specific choices:
- Sonarr/Radarr: Best-in-class for automated media management
- Prowlarr: Unified indexer management
- qBittorrent: Reliable, open-source torrent client
- Gluetun: Robust VPN management
- Jellyfin/Emby/Plex: Top-tier media streaming options
Don’t agree with our choices? That’s totally fine! You can always use our source code as inspiration for your own setup. 🔧
Platform Support
Can I run YAMS on Windows?
While technically possible with Docker for Windows, we don’t officially support it. Check out WIMPS instead - it’s inspired by YAMS but built specifically for Windows! Although the project has been archived, it could provide a better starting point than YAMS.
What about macOS?
Similar to Windows - it might work, but we focus on Linux support for the best experience. If you’re on macOS, consider running YAMS in a Linux VM.
Which Linux distributions are supported?
- Recommended: Debian 12
- Also Supported: Ubuntu 22.04
- Other distros might work but aren’t officially supported
Advanced Usage
How do I add custom containers?
Easy! Check out our Adding Custom Containers guide. You can add any Docker container to work alongside YAMS.
Can I modify YAMS’s default settings?
Absolutely! While YAMS comes with sensible defaults, you can customize:
- Container configurations
- Download settings
- Media organization
- Network settings
- And much more!
Need more advanced configurations?
Check out TRaSH Guides - they’re fantastic for deep-diving into each component’s settings!
Network & VPN
Can I add more containers to the VPN?
Yes! Everything’s documented in the VPN guide. Your config file is in /opt/yams/docker-compose.yaml (or your custom install location).
Which VPN providers work with YAMS?
We support many popular providers! Check our VPN Configuration page for the full list.
Troubleshooting
Getting Docker permission errors?
Common issue! Check our Common Errors page for the fix.
Services not starting?
- Check the logs:
docker logs container-name - Verify permissions
- Check our Common Issues page
Getting Help 🆘
Need more help? We’ve got you covered!
Documentation
- Check relevant service docs
- Review our Common Issues page
- Search existing forum posts
Community
Issues & Bugs
- Check our GitLab Issues
- Search for similar problems
- Create a new issue if needed
Contributing 🤝
Want to help make YAMS better? Awesome!
- Fork our repository
- Make your changes
- Submit a pull request
- Or help improve our documentation!
Remember: YAMS is a community project, and we welcome all contributions! 🌟
