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?

Check group membership:
```
groups $USER
```
You should see ‘docker’ in the list.
Verify socket permissions:
```
ls -l /var/run/docker.sock
```
Should show: srw-rw---- 1 root docker
Check Docker service:
```
systemctl status docker
```

VPN Issues

Gluetun Won’t Connect 🔌

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

Check Gluetun Logs
```
docker logs -n 100 gluetun
```
Common Error Messages:
- “Authentication failed”: Check your VPN credentials
- “Network unreachable”: Check your internet connection
- “No such host”: DNS issues - check your network settings

Verify VPN Settings

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

Test VPN Connection
```
yams check-vpn
```
Provider-Specific Issues:
- ProtonVPN: Make sure to use the correct username (OpenVPN / IKEv2 username)
- Mullvad: Account number needs to be exactly 16 digits
- NordVPN: Use your token, not your regular password

Quick VPN Fixes 🛠️

Reset VPN Connection
```
yams restart
```
Force Container Recreation
```
yams destroy
yams start
```
Verify Network Settings
```
docker network ls
```

Download Client Issues

qBittorrent Not Accessible 🔒

Check if VPN is Enabled
- Review VPN Configuration
- Run VPN check:
```
yams check-vpn
```
Verify Port Mappings
```
docker ps | grep qbittorrent
```
Should show port 8081 mapped

Check Network Mode In docker-compose.yaml:

qbittorrent:
  network_mode: "service:gluetun"

Review Logs
```
docker logs qbittorrent
```

SABnzbd Connection Issues 📡

Check Service Status
```
docker ps | grep sabnzbd
```
Verify Config Look for:
```
sabnzbd:
  ports:
    - 8080:8080
```
Check Logs
```
docker logs sabnzbd
```

Media Server Issues

Jellyfin/Emby/Plex Can’t Find Media 📺

Check Permissions
```
ls -l /your/media/directory
```
Should be owned by PUID:PGID from your .env file
Verify Mount Points
```
docker inspect your-media-server
```
Look for “Mounts” section
Path Issues
- Inside container: /data/movies, /data/tv
- On host: Your MEDIA_DIRECTORY paths
Scan Library
- Trigger manual scan in web UI
- Check library paths in settings

Performance Issues

High CPU Usage 🔥

Check Container Stats
```
docker stats
```
Monitor System Resources
```
top
# or
htop
```
Review Logs for Issues
```
docker logs --tail 100 container-name
```

Memory Problems 💾

Check Available Memory
```
free -h
```

Monitor Container Memory

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

Adjust Container Limits In docker-compose.yaml:

services:
  your-service:
    mem_limit: 1g

Getting More Help 🆘

Still stuck? We’ve got your back!

Check Detailed Logs

# All container logs
docker-compose logs

# Specific container
docker-compose logs container-name

Community Resources
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! 💪

Faqs

Common Issues