Troubleshooting Guide

Solutions to common problems you may encounter with archiving tools.

Installation & Dependency Issues

Problem

An AUR package fails to build with yay or paru.

Solution

  • Read the comments on the AUR page - other users often find solutions
  • Ensure your system is fully updated: sudo pacman -Syu
  • Check for missing dependencies in the build output
  • Try cleaning the build cache: yay -Sc

Download & Crawling Failures

Problem

yt-dlp gives "403 Forbidden" or similar errors on a specific site.

Solution

  1. Update to the latest version: sudo pacman -Syu yt-dlp
  2. If still failing, the site may require login - use browser cookies:
Using browser cookies
# Use cookies from Firefox
yt-dlp --cookies-from-browser firefox URL

# Or Chrome
yt-dlp --cookies-from-browser chrome URL

Performance & Resource Problems

Problem

Recoll or Baloo constantly uses high CPU.

Solution

  • Narrow the scope - exclude system dirs, downloads, cache directories
  • Point indexer only to your stable archive root
  • Schedule main indexing to run at night via systemd timer

Configuration & Permission Errors

Problem

Docker container cannot write to a mounted host directory.

Solution

This is almost always a permission issue. The UID/GID inside the container doesn't match the host directory.

Fix Docker permissions
# Find your user's UID/GID
id $USER
# Output: uid=1000(user) gid=1000(user)

# In docker-compose.yml, add:
environment:
  - PUID=1000
  - PGID=1000