yams.media/content/faqs/common-errors.md

title, date, draft, weight, summary

title	date	draft	weight	summary
Common Issues	2023-10-22T10:22:29-03:00	false	1	Solutions for common YAMS problems and how to fix them

Common YAMS Issues & Solutions 🔧

Docker Issues

Permission Denied Errors 🚫

Getting this error when running YAMS commands?

permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock

Quick Fix:

# Add yourself to the docker group
sudo usermod -aG docker $USER

# Log out and back in, or run:
newgrp docker

Still having issues?

1. Check group membership:

   groups $USER
   

   You should see 'docker' in the list.

2. Verify socket permissions:

   ls -l /var/run/docker.sock
   

   Should show: srw-rw---- 1 root docker

3. Check Docker service:

   systemctl status docker
   

VPN Issues

Gluetun Won't Connect 🔌

If your VPN isn't working, let's troubleshoot step by step:

1. Check Gluetun Logs

   docker logs -n 100 gluetun
   

2. Common Error Messages:

   • "Authentication failed": Check your VPN credentials
   • "Network unreachable": Check your internet connection
   • "No such host": DNS issues - check your network settings

3. Verify VPN Settings

   # In your .env file
   VPN_ENABLED=y
   VPN_SERVICE=your_provider
   VPN_USER=your_username
   VPN_PASSWORD=your_password
   

4. Test VPN Connection

   yams check-vpn
   

5. Provider-Specific Issues:

   • ProtonVPN: Make sure to use the correct username format (numbers only)
   • Mullvad: Account number needs to be exactly 16 digits
   • NordVPN: Use your token, not your regular password

Quick VPN Fixes 🛠️

1. Reset VPN Connection

   yams restart
   

2. Force Container Recreation

   yams destroy
   yams start
   

3. Verify Network Settings

   docker network ls
   

Download Client Issues

qBittorrent Not Accessible 🔒

1. Check if VPN is Enabled

   • Review VPN Configuration
   • Run VPN check:

     yams check-vpn
     

2. Verify Port Mappings

   docker ps | grep qbittorrent
   

   Should show port 8081 mapped

3. Check Network Mode In docker-compose.yaml:

   qbittorrent:
     network_mode: "service:gluetun"
   

4. Review Logs

   docker logs qbittorrent
   

SABnzbd Connection Issues 📡

1. Check Service Status

   docker ps | grep sabnzbd
   

2. Verify Config Look for:

   sabnzbd:
     ports:
       - 8080:8080
   

3. Check Logs

   docker logs sabnzbd
   

Media Server Issues

Jellyfin/Emby/Plex Can't Find Media 📺

1. Check Permissions

   ls -l /your/media/directory
   

   Should be owned by PUID:PGID from your .env file

2. Verify Mount Points

   docker inspect your-media-server
   

   Look for "Mounts" section

3. Path Issues

   • Inside container: /data/movies, /data/tv
   • On host: Your MEDIA_DIRECTORY paths

4. Scan Library

   • Trigger manual scan in web UI
   • Check library paths in settings

Performance Issues

High CPU Usage 🔥

1. Check Container Stats

   docker stats
   

2. Monitor System Resources

   top
   # or
   htop
   

3. Review Logs for Issues

   docker logs --tail 100 container-name
   

Memory Problems 💾

1. Check Available Memory

   free -h
   

2. Monitor Container Memory

   docker stats --format "table {{.Name}}\t{{.MemUsage}}"
   

3. Adjust Container Limits In docker-compose.yaml:

   services:
     your-service:
       mem_limit: 1g
   

Getting More Help 🆘

Still stuck? We've got your back!

1. Check Detailed Logs

   # All container logs
   docker-compose logs
   
   # Specific container
   docker-compose logs container-name
   

2. Community Resources

   • YAMS Forum
   • Discord Chat
   • Matrix Room

3. Report Issues

   • Check existing GitLab issues
   • Provide logs and configuration when reporting new issues

Remember: Most issues have simple solutions! If you're stuck, our community is here to help! 💪