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

---
title: "Common Issues"
date: 2023-10-22T10:22:29-03:00
draft: false
weight: 1
summary: 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?
```bash
permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock
```

**Quick Fix:**
```bash
# 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:
   ```bash
   groups $USER
   ```
   You should see 'docker' in the list.

2. Verify socket permissions:
   ```bash
   ls -l /var/run/docker.sock
   ```
   Should show: `srw-rw---- 1 root docker`

3. Check Docker service:
   ```bash
   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**
   ```bash
   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**
   ```bash
   # In your .env file
   VPN_ENABLED=y
   VPN_SERVICE=your_provider
   VPN_USER=your_username
   VPN_PASSWORD=your_password
   ```

4. **Test VPN Connection**
   ```bash
   yams check-vpn
   ```

5. **Provider-Specific Issues:**
   - **ProtonVPN**: Make sure to use the correct username ([OpenVPN / IKEv2 username](https://account.proton.me/u/0/vpn/OpenVpnIKEv2))
   - **Mullvad**: Account number needs to be exactly 16 digits
   - **NordVPN**: Use your token, not your regular password

### Quick VPN Fixes 🛠️

1. **Reset VPN Connection**
   ```bash
   yams restart
   ```

2. **Force Container Recreation**
   ```bash
   yams destroy
   yams start
   ```

3. **Verify Network Settings**
   ```bash
   docker network ls
   ```

## Download Client Issues

### qBittorrent Not Accessible 🔒

1. **Check if VPN is Enabled**
   - Review [VPN Configuration](/advanced/vpn/)
   - Run VPN check:
     ```bash
     yams check-vpn
     ```

2. **Verify Port Mappings**
   ```bash
   docker ps | grep qbittorrent
   ```
   Should show port 8081 mapped

3. **Check Network Mode**
   In `docker-compose.yaml`:
   ```yaml
   qbittorrent:
     network_mode: "service:gluetun"
   ```

4. **Review Logs**
   ```bash
   docker logs qbittorrent
   ```

### SABnzbd Connection Issues 📡

1. **Check Service Status**
   ```bash
   docker ps | grep sabnzbd
   ```

2. **Verify Config**
   Look for:
   ```yaml
   sabnzbd:
     ports:
       - 8080:8080
   ```

3. **Check Logs**
   ```bash
   docker logs sabnzbd
   ```

## Media Server Issues

### Jellyfin/Emby/Plex Can't Find Media 📺

1. **Check Permissions**
   ```bash
   ls -l /your/media/directory
   ```
   Should be owned by PUID:PGID from your .env file

2. **Verify Mount Points**
   ```bash
   docker inspect your-media-server
   ```
   Look for "Mounts" section

3. **Path Issues**
   - Inside container: `/data/movies`, `/data/tvshows`
   - 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**
   ```bash
   docker stats
   ```

2. **Monitor System Resources**
   ```bash
   top
   # or
   htop
   ```

3. **Review Logs for Issues**
   ```bash
   docker logs --tail 100 container-name
   ```

### Memory Problems 💾

1. **Check Available Memory**
   ```bash
   free -h
   ```

2. **Monitor Container Memory**
   ```bash
   docker stats --format "table {{.Name}}\t{{.MemUsage}}"
   ```

3. **Adjust Container Limits**
   In docker-compose.yaml:
   ```yaml
   services:
     your-service:
       mem_limit: 1g
   ```

## Getting More Help 🆘

Still stuck? We've got your back!

1. **Check Detailed Logs**
   ```bash
   # All container logs
   docker-compose logs

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

2. **Community Resources**
   - [YAMS Forum](https://forum.yams.media)
   - [Discord Chat](https://discord.gg/Gwae3tNMST)
   - [Matrix Room](https://matrix.to/#/#yams-space:rogs.me)

3. **Report Issues**
   - Check existing [GitLab issues](https://gitlab.com/rogs/yams/-/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! 💪